Overzicht
API-toegang, webhooks en realtime events voor integraties
De Tillor API biedt programmatische toegang tot je organisatiedata. Gebruik API-sleutels voor authenticatie, webhooks voor uitgaande events, of Server-Sent Events (SSE) voor realtime streaming.
Wat kun je bouwen?
- Integraties - Koppel Tillor aan je eigen systemen via de REST API
- Webhooks - Ontvang HTTP POST-berichten wanneer events plaatsvinden (factuur betaald, klant aangemaakt, etc.)
- Realtime dashboards - Stream events via SSE of MQTT voor live updates in je applicatie
Snel aan de slag
- Maak een API-sleutel in Tillor onder Instellingen → API-sleutels
- Stuur de sleutel in de
x-api-keyheader bij elke request - Voeg
X-Tillor-Org-Idtoe met je organisatie-ID voor organisatie-specifieke endpoints
Zelfde events
Webhooks en SSE leveren exact dezelfde events. Het verschil: webhooks sturen HTTP POST naar jouw URL; SSE is een lange verbinding waar je events op ontvangt.
Handige links: API Playground · OpenAPI
Scope: API-sleutels zijn per account (alle organisaties); webhooks zijn per organisatie.
HTTP API
API-sleutels, authenticatie, base URL en organisatie-context
Webhooks
Ontvang events via HTTP POST naar jouw endpoint
SSE
Stream realtime events via Server-Sent Events
MQTT
Pub/sub via MQTT met strikte topic-toegang en JWT of statische credentials
Voorbeelden
Code- en payload-voorbeelden voor HTTP, Webhooks en SSE