Mosaqo API
Veřejné API a webhooky pro automatizaci QR
Mosaqo Public API používá klíče s rozsahem pracovního prostoru. Začněte s minimálním rozsahem, používejte klíč Idempotency pro zápisy a respektujte Retry-After, když je rychlost omezena.
RYCHLÝ PŘEHLED
Co to mění v praxi
01
Autentizace a rozsahy
Pošlete tajemství v X-Mosaqo-API-Key. Dostupné rozsahy zahrnují qr:read, qr:write, exports:read a analytics:read. Klíčům může vypršet platnost, mohou být odvolány nebo mohou používat seznam povolených IP adres.
- Nikdy nevkládejte tajemství do klientského JavaScriptu
- Pro každou integraci použijte jeden klíč
- Otočte po podezření na expozici
02
Bezpečné opakování zápisu
Požadavky na vytváření a publikování vyžadují klíč Idempotency o délce 1 až 128 znaků. Znovu použijte klíč pouze pro opakování stejného užitečného zatížení do 24 hodin.
03
Omezení rychlosti a chyby
Na HTTP 429 si přečtěte Retry-After a zkuste to znovu s backoffem. 401 obvykle označuje chybějící, odvolaný, vypršela platnost, omezený nebo nedostatečně vymezený klíč.
04
Webhooky
Přihlašte se pouze k potřebným událostem, přijímejte je na HTTPS a rychle reagujte. Mosaqo zaznamenává stav doručení a podporuje přehrávání z pracovního prostoru.
FAQ
Časté dotazy
Kde je kompletní smlouva o API?
Smlouva OpenAPI 3.1 je verzována s Mosaqo API. Vytvořte klíč ve webovém pracovním prostoru a použijte publikovanou smlouvu pro podrobnosti o koncovém bodu.
DALŠÍ KROK