De open API en webhooks gebruiken
Haal producten, klanten, voorraad en verkopen op met API-sleutels, en ontvang gebeurtenissen met een handtekening.
Onder Developers in de backoffice bouw je je eigen koppeling met TILLIO. Je vindt er je API-sleutels, je webhooks en de documentatie.
API-sleutels
- 1Maak een sleutel aan en kies Lezen of Lezen + schrijven.
- 2Kopieer de sleutel meteen. Je ziet hem maar één keer: bewaar hem veilig.
- 3Stuur bij elke aanroep een
Authorization: Bearer-header met je sleutel mee.
Wat kun je ophalen?
- Producten, met varianten en foto's.
- Klanten. Een klant aanmaken vraagt een sleutel met lezen en schrijven.
- Voorraad per product of variant. Je zet de absolute stand; TILLIO berekent zelf de mutatie.
- Afgeronde verkopen met hun regels en betalingen.
Een verkoop registreren via de API kan niet: dat blijft via de kassa lopen. Per sleutel mag je standaard 60 aanvragen per minuut doen, en je kunt dat per sleutel aanpassen. Bij overschrijding krijg je een foutmelding 429, met de tijd waarna je opnieuw mag proberen.
Webhooks
Voeg een webhook toe met het adres van jouw toepassing. TILLIO stuurt gebeurtenissen, zoals verkopen en voorraadwijzigingen, naar dat adres. Controleer de handtekening in de header X-Tillio-Signature: dat is een HMAC-SHA256 van de ruwe inhoud, in hexadecimale vorm, met het geheim van jouw adres. Dat geheim zie je maar één keer.
Laatst bijgewerkt op 25 oktober 2026.