APIの概要
これはCapgo cloudのパブリックAPIのドキュメントです。APIを使用すると、組織、デバイス、チャネル、バンドルなど、Capgoリソースをプログラムで管理できます。RESTful設計で、標準のHTTPメソッドを使用しています。
すべてのAPIエンドポイントは認証が必要です。リクエストを認証するには、authorizationヘッダーにAPIキーを追加してください。
例:
curl -H "authorization: your-api-key" https://api.capgo.app/organization/ APIキーを取得 CapgoダッシュボードでAPIキーを生成
APIは公平な使用を保証するためにレート制限を実装しています。現在の制限は:
- 標準アカウントで1分あたり100リクエスト
- エンタープライズアカウントで1分あたり1000リクエスト
これらの制限を超えると、429 (Too Many Requests)レスポンスが返されます。
レスポンス形式
Section titled “レスポンス形式”すべてのレスポンスはJSON形式です。成功レスポンスには通常、dataオブジェクトまたはstatusフィールドが含まれます。エラーレスポンスには、何が問題だったかの説明を含むerrorフィールドが含まれます。
成功レスポンスの例:
{ "status": "ok", "data": { ... }}エラーレスポンスの例:
{ "error": "Invalid API key", "status": "KO"}利用可能なエンドポイント
Section titled “利用可能なエンドポイント” 組織 組織を作成および管理し、設定を更新し、組織レベルの構成を処理
APIキー Capgo APIへの安全なアクセスのためのAPIキーの生成、リスト、取り消し
メンバー 組織メンバー、ロール、権限の管理
統計 アプリの使用状況、ストレージ、帯域幅消費に関する詳細な分析にアクセス
チャネル アプリの更新チャネル、バージョン、更新ポリシーの制御
デバイス アプリを実行しているデバイスを追跡および管理し、バージョンとチャネルの割り当てを含む
バンドル アップロード、リスト、バージョン管理など、アプリバンドルの処理
ベストプラクティス
Section titled “ベストプラクティス”- エラー処理: 常にエラーレスポンスをチェックし、適切に処理してください
- レート制限: レート制限に達した場合は指数バックオフを実装してください
- キャッシング: API呼び出しを減らすために、適切な場合はレスポンスをキャッシュしてください
- バージョン管理: 変更履歴を通じてAPIの変更を追跡してください