コンテンツにジャンプ

API の概要

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

認証

認証

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

例:

ターミナルウィンドウ
curl -H "x-api-key: YOUR_API_KEY" https://api.capgo.app/organization/

この authorization header is still accepted for legacy API keys, but x-api-key リクエスト制限

The API implements rate limiting to ensure fair usage. Current limits are:

  • __CAPGO_KEEP_1__
  • 1000 件あたりの分単位でエンタープライズアカウントのリクエスト制限

__CAPGO_KEEP_0__ を超えると、429 (Too Many Requests) の応答を受け取ります。

すべての応答は JSON 形式です。成功応答は、オブジェクトまたはフィールドを含むことがよくあります。エラー応答は、エラーが発生した理由の説明が記載されたフィールドを含みます。 data 成功応答の例: status __CAPGO_KEEP_1__ error エラー応答の例:

__CAPGO_KEEP_2__

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

__CAPGO_KEEP_4__

{
"error": "Invalid API key",
"status": "KO"
}
  1. エラー処理常にエラー応答を確認し、適切に処理する
  2. レート制限レート制限に当たった場合、指数バックオフを実装する
  3. キャッシング適切な場合にレスポンスをキャッシュし、API呼び出しを減らす
  4. バージョニングAPIの変更履歴を通じて、APIの変更を追跡する

APIの概要から進めましょう

APIの概要から進めましょう

Capacitorを使用している場合 APIの概要 Capacitorを使用して認証とアカウントフローの計画を行っている場合、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-social-login Capacitorを使用して認証とアカウントフローの計画を行っている場合、@capgo/capacitor-social-loginの実装詳細については、@capgo/capacitor-social-loginを参照してください。 Capacitorを使用して認証とアカウントフローの計画を行っている場合、@capgo/capacitor-passkey Capacitorを使用して認証とアカウントフローの計画を行っている場合、@capgo/capacitor-passkeyの実装詳細については、@capgo/capacitor-passkeyを参照してください。 Capacitorを使用して認証とアカウントフローの計画を行っている場合、@capgo/capacitor-native-biometric Capacitorを使用して認証とアカウントフローの計画を行っている場合、@capgo/capacitor-native-biometricの実装詳細については、@capgo/capacitor-native-biometricを参照してください。 実装詳細の詳細については @capgo/capacitor-native-biometric に参照してください。 2要素認証 実装詳細の詳細については 2要素認証、 SSO (企業) 実装詳細の詳細については SSO (企業) に参照してください。