Mokapen API dokumentácia

Webhooky

Webhooky upozornia vašu aplikáciu, keď sú entity vytvorené, aktualizované alebo odstránené v Mokapen. Použite ich na integrácie riadené udalosťami namiesto REST API na dopytovanie.

Prehľad

Zaregistrujte webovú adresu webhooku a vyberte udalosti, ktoré chcete prijímať. Keď dôjde k udalosti, Mokapen odošle požiadavku HTTP POST do vášho koncového bodu s JSON dátovým zaťažením.

Koncové body správy webhooku vyžadujú platný token nosiča s príslušnými rozsahmi.

Koncový bod rozhrania Webhook API

ZÍSKAJTE /api/webhooks
POST /api/webhooks
PUT /api/webhooks/{webhook_id}
ODSTRÁNIŤ /api/webhooks/{webhook_id}
ZÍSKAJTE /api/webhooks/{webhook_id}/logs
ZÍSKAJTE /api/webhook-events

Nahrajte webhook

Odoslať POST s webovou adresou spätného volania, ID organizácie a vybratými udalosťami:

POST /api/webhooks
Autorizácia: Nositeľ YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "url": "https://example.com/webhooks/mokapen",
  "org_id": 849,
  "events": ["task.created", "task.updated", "contact.created"]
}

Bezpečnosť

Skontrolujte prichádzajúce požiadavky webhooku na vašom serveri. Používajte iba koncové body HTTPS. Uchovávajte tajomstvá bezpečne a overte užitočné zaťaženie pred ich spracovaním.

Podporované udalosti webhooku

Zaznamenaním webhooku sa môžete prihlásiť na odber jednej alebo viacerých z nasledujúcich udalostí:

  • task.created
  • task.updated
  • task.deleted
  • project.created
  • project.updated
  • project.deleted
  • contact.created
  • contact.updated
  • contact.deleted
  • company.created
  • company.updated
  • company.deleted
  • ticket.created
  • ticket.updated
  • ticket.deleted
  • booking.created
  • booking.updated
  • booking.deleted
  • product.created
  • product.updated
  • product.deleted
  • service.created
  • service.updated
  • service.deleted
  • quote.created
  • quote.updated
  • quote.deleted
  • order.created
  • order.updated
  • order.deleted
  • deal.created
  • deal.updated
  • deal.deleted
  • appointment.created
  • appointment.updated
  • appointment.deleted
  • document.created
  • document.updated
  • document.deleted
  • campaign.created
  • campaign.updated
  • campaign.deleted

Potrebujete pomoc?