Mokapen API-documentatie

Webhaken

Webhooks stellen uw toepassing op de hoogte wanneer entiteiten worden gemaakt, bijgewerkt of verwijderd in Mokapen. Gebruik ze voor gebeurtenisgestuurde integraties in plaats van het pollen van REST API's.

Overzicht

Registreer een webhook-URL en selecteer gebeurtenissen die u wilt ontvangen. Wanneer er een gebeurtenis plaatsvindt, verzendt Mokapen een HTTP POST-verzoek naar uw eindpunt met JSON-payload.

Voor webhookbeheereindpunten is een geldig Bearer-token met de juiste bereiken vereist.

Webhook API-eindpunt

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

Neem een ​​webhook op

Stuur een POST met de callback-URL, organisatie-ID en geselecteerde evenementen:

POST /api/webhooks
Autorisatie: drager YOUR_ACCESS_TOKEN
Inhoudstype: application/json

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

Veiligheid

Controleer inkomende webhookverzoeken op uw server. Gebruik alleen HTTPS-eindpunten. Bewaar geheimen veilig en valideer payloads voordat u ze verwerkt.

Webhook-evenementen ondersteund

Door een webhook op te nemen, kunt u zich abonneren op een of meer van de volgende evenementen:

  • 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

Heeft u hulp nodig?