コンテンツへスキップ

APIの概要

これはCapgo cloudのパブリックAPIのドキュメントです。APIを使用すると、組織、デバイス、チャネル、バンドルなど、Capgoリソースをプログラムで管理できます。RESTful設計で、標準のHTTPメソッドを使用しています。

すべてのAPIエンドポイントは認証が必要です。リクエストを認証するには、authorizationヘッダーにAPIキーを追加してください。

例:

Terminal window
curl -H "authorization: your-api-key" https://api.capgo.app/organization/

APIは公平な使用を保証するためにレート制限を実装しています。現在の制限は:

  • 標準アカウントで1分あたり100リクエスト
  • エンタープライズアカウントで1分あたり1000リクエスト

これらの制限を超えると、429 (Too Many Requests)レスポンスが返されます。

すべてのレスポンスはJSON形式です。成功レスポンスには通常、dataオブジェクトまたはstatusフィールドが含まれます。エラーレスポンスには、何が問題だったかの説明を含むerrorフィールドが含まれます。

成功レスポンスの例:

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

エラーレスポンスの例:

{
"error": "Invalid API key",
"status": "KO"
}
  1. エラー処理: 常にエラーレスポンスをチェックし、適切に処理してください
  2. レート制限: レート制限に達した場合は指数バックオフを実装してください
  3. キャッシング: API呼び出しを減らすために、適切な場合はレスポンスをキャッシュしてください
  4. バージョン管理: 変更履歴を通じてAPIの変更を追跡してください