MOSAQO API
Public API та webhooks для автоматизації QR-кодів
Mosaqo Public API працює через workspace-scoped ключі. Починайте з мінімального scope, використовуйте Idempotency-Key для запису та обробляйте 429 із Retry-After.
ШВИДКИЙ ОГЛЯД
Що це дає на практиці
01
Автентифікація та scopes
Передавайте secret у заголовку X-Mosaqo-API-Key. Доступні scopes qr:read, qr:write, exports:read та analytics:read. Ключ можна відкликати, обмежити строком дії або IP allow-list.
- Не вставляйте secret у client-side JavaScript
- Окремий ключ для кожної інтеграції
- Ротуйте ключ після підозри на витік
02
Безпечні повтори запису
Запити створення та публікації потребують Idempotency-Key довжиною 1–128 символів. Повторюйте той самий ключ лише для retry ідентичного запиту протягом 24 годин. Інший payload із тим самим ключем поверне conflict.
03
Rate limiting і помилки
На 429 прочитайте Retry-After і повторіть запит після вказаної кількості секунд із backoff. Не використовуйте нескінченний tight loop. 401 зазвичай означає відсутній, відкликаний, прострочений або недостатньо scoped ключ.
04
Webhooks
Підпишіться на потрібні події, перевіряйте доставку на своєму HTTPS endpoint і відповідайте швидко. Mosaqo зберігає delivery status та дозволяє replay з workspace.
FAQ
Часті запитання
Де повна OpenAPI схема?
Контракт версіонується разом із Mosaqo API. У web workspace можна створити ключ, а актуальні endpoint details надаються в OpenAPI 3.1 описі продукту.
НАСТУПНИЙ КРОК