Mokapen API dokumentation

Webhooks

Webhooks giver din applikation besked, når entiteter oprettes, opdateres eller slettes i Mokapen. Brug dem til hændelsesdrevne integrationer i stedet for at polle REST API'er.

Oversigt

Registrer en webhook-URL, og vælg begivenheder, der skal modtages. Når en hændelse opstår, sender Mokapen en HTTP POST-anmodning til dit slutpunkt med JSON-nyttelast.

Webhook-administrationsslutpunkter kræver et gyldigt bærer-token med det relevante omfang.

Webhook API-slutpunkt

GET    /api/webhooks
POST   /api/webhooks
PUT    /api/webhooks/{webhook_id}
DELETE /api/webhooks/{webhook_id}
GET    /api/webhooks/{webhook_id}/logs
GET    /api/webhook-events

Optag en webhook

Send et POST med tilbagekalds-URL, organisations-id og valgte begivenheder:

POST /api/webhooks
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

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

Sikkerhed

Tjek indgående webhook-anmodninger på din server. Brug kun HTTPS-endepunkter. Opbevar hemmeligheder sikkert og valider nyttelast, før du behandler dem.

Webhook-begivenheder understøttes

Ved at optage en webhook kan du abonnere på en eller flere af følgende begivenheder:

  • 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

Har du brug for hjælp?