Mosaqo-API
Openbare API en webhooks voor QR-automatisering
Mosaqo De openbare API maakt gebruik van sleutels voor de werkruimte. Begin met het minimale bereik, gebruik Idempotency-Key voor schrijfbewerkingen en respecteer Retry-After als de snelheid beperkt is.
SNEL OVERZICHT
Wat dit in de praktijk verandert
01
Authenticatie en bereik
Verzend het geheim in X-Mosaqo-API-Key. Beschikbare bereiken zijn onder meer qr:read, qr:write, exports:read en analytics:read. Sleutels kunnen verlopen, worden ingetrokken of een IP-toelatingslijst gebruiken.
- Plaats nooit een geheim in client-JavaScript
- Gebruik één sleutel per integratie
- Roteren na vermoedelijke blootstelling
02
Nieuwe pogingen tot veilig schrijven
Voor het maken en publiceren van verzoeken is een Idempotency-Key tussen 1 en 128 tekens vereist. Gebruik de sleutel alleen opnieuw om binnen 24 uur de identieke lading opnieuw te proberen.
03
Tarieflimieten en fouten
Lees op HTTP 429 Retry-After en probeer het opnieuw met uitstel. Een 401 duidt meestal op een ontbrekende, ingetrokken, verlopen, beperkte of onvoldoende bereikbare sleutel.
04
Webhooks
Abonneer u alleen op de benodigde evenementen, accepteer ze op HTTPS en reageer snel. Mosaqo registreert de leveringsstatus en ondersteunt afspelen vanuit de werkruimte.
FAQ
Veelgestelde vragen
Waar is het volledige API-contract?
Het OpenAPI 3.1-contract is voorzien van een versie met de Mosaqo API. Maak een sleutel in de webwerkruimte en gebruik het gepubliceerde contract voor eindpuntdetails.
VOLGENDE STAP