Lompat ke konten

API Ringkasan

Ini adalah dokumentasi dari API publik Capgo cloud. API memungkinkan Anda mengelola sumber daya Capgo Anda secara programatik, termasuk organisasi, perangkat, saluran, dan paket. Ini dirancang untuk menjadi RESTful dan menggunakan metode HTTP standar.

Semua API endpoint memerlukan autentikasi. Untuk mengautentikasi permintaan Anda, tambahkan kunci API Anda di x-api-key header.

Contoh:

Jendela terminal
curl -H "x-api-key: YOUR_API_KEY" https://api.capgo.app/organization/

Header masih diterima untuk kunci __CAPGO_KEEP_0__ legacy, tetapi authorization header is still accepted for legacy API keys, but x-api-key adalah header yang direkomendasikan untuk semua jenis kunci, termasuk kunci yang dihash dengan aman.

API mengimplementasikan limitasi penggunaan untuk memastikan penggunaan yang adil. Batasan saat ini adalah:

  • 100 permintaan per menit untuk akun standar
  • 1000 permintaan per menit untuk akun bisnis

Jika Anda melebihi batasan ini, Anda akan menerima respons 429 (Terlalu Banyak Permintaan).

Pengubahan saluran perangkat menggunakan plugin API dan memiliki batasan pencegahan penyalahgunaan yang berbeda yang berlaku untuk setiap paket, termasuk trial:

  • Sebuah perangkat dapat membuat hingga 5 permintaan per detik untuk setiap operasi saluran (set, get, delete, atau list. Batasan ini berlaku pada aplikasi, perangkat, dan operasi.
  • Pengaturan perangkat yang sama ke saluran yang sama lebih dari sekali dalam 60 detik akan mengembalikan respons 429. Mengganti ke saluran yang berbeda diperbolehkan setelah batasan per-detik reset.
  • Batasan tambahan 1000 permintaan saluran per menit berlaku untuk setiap aplikasi dan alamat IP.

Batasan-batasan ini bukanlah batasan akun. Jika pengganti saluran Anda dapat kembali ke saluran yang dipilih sebelumnya, tunggu selama durasi di respons 429 sebelum mencoba lagi. retryAfterSeconds Format Respons

Contoh respons sukses: data __CAPGO_KEEP_0__ status __CAPGO_KEEP_1__ error __CAPGO_KEEP_2__

__CAPGO_KEEP_3__

{
"status": "ok",
"data": { ... }
}

Contoh respons kesalahan:

{
"error": "Invalid API key",
"status": "KO"
}

Praktik Terbaik

Error Handling
  1. Selalu periksa respons kesalahan dan tangani dengan tepatPengaturan Batas Kelajuan
  2. __CAPGO_KEEP_0__Mengimplementasikan backoff eksponensial ketika menabrak batasan kecepatan
  3. Penggunaan CacheMeng-cache respons ketika sesuai untuk mengurangi API panggilan
  4. Pengaturan VersiMengikuti perubahan API melalui catatan perubahan kami

Jika Anda menggunakan API Ringkasan untuk merencanakan autentikasi dan alur akun, hubungkannya dengan capacitor-capgo/capacitor-login-akun untuk detail implementasi di capgo/capacitor-login-akun, capgo/capacitor-passkey untuk detail implementasi di @capgo/capacitor-passkey capgo/capacitor-native-biometric untuk detail implementasi di @capgo/capacitor-native-biometric Autentikasi Dua Faktor untuk detail implementasi di Autentikasi Dua Faktor, dan SSO (Perusahaan) untuk detail implementasi di SSO (Perusahaan).