API Ringkasan

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

Autentikasi

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

Contoh:

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

Dapatkan kunci API Generate kunci API Anda di dashboard Capgo

Kepala 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.

Limitasi Penggunaan

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

Pengubahan saluran perangkat menggunakan plugin API dan memiliki batasan pencegahan penyalahgunaan yang berbeda yang berlaku untuk setiap rencana, termasuk uji coba:

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

Batasan-batasan ini bukan berlaku secara akun. Jika pengubah saluran Anda dapat kembali ke saluran yang dipilih sebelumnya, tunggu durasi dalam respons 429 sebelum mencoba lagi. retryAfterSeconds Format Respons

Bab berjudul “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"
}

Endpoint yang Tersedia

Organisasi Buat dan kelola organisasi, update pengaturan, dan atur konfigurasi tingkat organisasi

API Keys Generasi, daftar, dan batalkan API kunci untuk akses yang aman ke Capgo API

Anggota Kelola anggota organisasi, peran, dan izin

Statistik Analisis detail tentang penggunaan aplikasi, penyimpanan, dan konsumsi bandwidth

Saluran context

Kontrol saluran pembaruan aplikasi, paket (versi), dan kebijakan pembaruan Peralatan

context Manfaatkan perangkat yang menjalankan aplikasi, termasuk pengaturan paket (versi) dan saluran

Paket

1. Manfaatkan paket aplikasi, termasuk mengunggah, menampilkan, dan mengelola paket (versi)Praktik Terbaik
2. context: Implement exponential backoff ketika mencapai batasan kecepatan
3. Caching: Cache respons ketika sesuai untuk mengurangi API panggilan
4. Versi: Tahu perubahan API melalui catatan perubahan kami

Teruskan dari API Panduan

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