API Mosaqo
Publiczne API i webhooki do automatyzacji QR
Mosaqo Publiczny interfejs API używa kluczy o zasięgu obszaru roboczego. Zacznij od minimalnego zakresu, użyj klucza Idempotency do zapisów i przestrzegaj opcji Retry-After, gdy szybkość jest ograniczona.
SZYBKI PRZEGLĄD
Co to zmienia w praktyce
01
Uwierzytelnianie i zakresy
Wyślij sekret w X-Mosaqo-API-Key. Dostępne zakresy obejmują qr:read, qr:write, eksport:odczyt i analityka:odczyt. Klucze mogą wygasnąć, zostać unieważnione lub skorzystać z listy dozwolonych adresów IP.
- Nigdy nie umieszczaj sekretu w JavaScript klienta
- Użyj jednego klucza na integrację
- Obróć po podejrzeniu narażenia
02
Ponowne próby bezpiecznego zapisu
Tworzenie i publikowanie żądań wymaga klucza Idempotencji o długości od 1 do 128 znaków. Użyj klucza ponownie tylko w celu ponownej próby użycia identycznego ładunku w ciągu 24 godzin.
03
Limity szybkości i błędy
W przypadku protokołu HTTP 429 przeczytaj opcję Retry-After i spróbuj ponownie z wycofywaniem. Kod 401 zwykle oznacza brakujący, unieważniony, wygasły, ograniczony lub niewystarczająco ograniczony klucz.
04
Haki internetowe
Subskrybuj tylko potrzebne wydarzenia, akceptuj je na HTTPS i szybko reaguj. Mosaqo rejestruje status dostawy i obsługuje odtwarzanie z obszaru roboczego.
FAQ
Najczęstsze pytania
Gdzie jest pełna umowa API?
Wersja kontraktu OpenAPI 3.1 zawiera interfejs API Mosaqo. Utwórz klucz w internetowym obszarze roboczym i użyj opublikowanego kontraktu, aby uzyskać szczegółowe informacje o punkcie końcowym.
NASTĘPNY KROK