API Mosaqo
API Publik dan webhook untuk otomatisasi QR
API Publik Mosaqo menggunakan kunci cakupan ruang kerja. Mulailah dengan cakupan minimum, gunakan Kunci Idempotensi untuk penulisan dan hormati Retry-After ketika tarif terbatas.
SEKILAS
Apa yang berubah dalam praktiknya
01
Otentikasi dan cakupan
Kirim rahasia di X-Mosaqo-API-Key. Cakupan yang tersedia mencakup qr:baca, qr:tulis, ekspor:baca, dan analitik:baca. Kunci dapat kedaluwarsa, dicabut, atau menggunakan daftar IP yang diizinkan.
- Jangan pernah menempatkan rahasia di JavaScript klien
- Gunakan satu kunci per integrasi
- Putar setelah diduga terkena paparan
02
Percobaan ulang penulisan yang aman
Membuat dan mempublikasikan permintaan memerlukan Kunci Idempotensi antara 1 dan 128 karakter. Gunakan kembali kunci tersebut hanya untuk mencoba kembali muatan yang sama dalam waktu 24 jam.
03
Batasan nilai dan kesalahan
Pada HTTP 429, baca Retry-After dan coba lagi dengan backoff. Angka 401 biasanya menunjukkan kunci yang hilang, dicabut, kedaluwarsa, dibatasi, atau cakupannya tidak mencukupi.
04
Webhook
Berlangganan hanya ke acara yang diperlukan, terima acara tersebut di HTTPS, dan tanggapi dengan cepat. Mosaqo mencatat status pengiriman dan mendukung pemutaran ulang dari ruang kerja.
FAQ
Pertanyaan umum
Dimana kontrak API lengkapnya?
Kontrak OpenAPI 3.1 dibuat dengan versi API Mosaqo. Buat kunci di ruang kerja web dan gunakan kontrak yang dipublikasikan untuk detail titik akhir.
LANGKAH BERIKUTNYA