Mosaqo API
Public API och webhooks för QR-automatisering
Mosaqo Public API använder nycklar med arbetsyta. Börja med det minsta omfånget, använd Idempotency-Key för att skriva och respektera Försök igen-efter när hastigheten är begränsad.
SNABB ÖVERSIKT
Vad det här ändrar i praktiken
01
Autentisering och omfång
Skicka hemligheten i X-Mosaqo-API-Key. Tillgängliga omfång inkluderar qr:read, qr:write, exports:read och analytics:read. Nycklar kan löpa ut, återkallas eller använda en IP-tillåtelselista.
- Placera aldrig en hemlighet i klient JavaScript
- Använd en nyckel per integration
- Rotera efter misstänkt exponering
02
Säker skrivförsök
Skapa och publicera förfrågningar kräver en Idempotency-Key mellan 1 och 128 tecken. Återanvänd endast nyckeln för att försöka igen med identisk nyttolast inom 24 timmar.
03
Takstgränser och fel
På HTTP 429, läs Retry-After och försök igen med backoff. En 401 indikerar vanligtvis en saknad, återkallad, utgången, begränsad eller otillräckligt omfångsrik nyckel.
04
Webhooks
Prenumerera endast på nödvändiga händelser, acceptera dem på HTTPS och svara snabbt. Mosaqo registrerar leveransstatus och stöder uppspelning från arbetsytan.
FAQ
Vanliga frågor
Var finns det fullständiga API-kontraktet?
OpenAPI 3.1-kontraktet är versionerat med Mosaqo API. Skapa en nyckel i webbarbetsytan och använd det publicerade kontraktet för slutpunktsdetaljer.
NÄSTA STEG