Mosaqo API
Offentlig API og webhooks til QR-automatisering
Mosaqo Public API bruger nøgler med arbejdsområde. Start med minimumsomfanget, brug Idempotency-Key til at skrive og respekter Prøv igen-efter, når hastigheden er begrænset.
HURTIGT OVERBLIK
Hvad det ændrer i praksis
01
Godkendelse og omfang
Send hemmeligheden i X-Mosaqo-API-Key. Tilgængelige omfang omfatter qr:read, qr:write, exports:read og analytics:read. Nøgler kan udløbe, tilbagekaldes eller bruge en IP-tilladelsesliste.
- Placer aldrig en hemmelighed i klient JavaScript
- Brug én nøgle pr. integration
- Roter efter mistanke om eksponering
02
Sikker skriveforsøg igen
Opret og udgiv anmodninger kræver en Idempotency-nøgle på mellem 1 og 128 tegn. Genbrug kun nøglen for at prøve den identiske nyttelast igen inden for 24 timer.
03
Takstgrænser og fejl
På HTTP 429 skal du læse Retry-After og prøve igen med backoff. En 401 angiver normalt en manglende, tilbagekaldt, udløbet, begrænset eller utilstrækkeligt omfangsrig nøgle.
04
Webhooks
Abonner kun på nødvendige begivenheder, accepter dem på HTTPS og svar hurtigt. Mosaqo registrerer leveringsstatus og understøtter genafspilning fra arbejdsområdet.
FAQ
Ofte stillede spørgsmål
Hvor er den komplette API-kontrakt?
OpenAPI 3.1-kontrakten er versioneret med Mosaqo API. Opret en nøgle i webarbejdsområdet, og brug den offentliggjorte kontrakt til slutpunktsdetaljer.
NÆSTE SKRIDT