API認証
Amplitude APIは、エンドポイントに応じて異なる認証情報を使用します。キーを送信する前に、呼び出したエンドポイントのAPIリファレンスを確認してください。
分析 REST API リクエストを認証する
Export APIとダッシュボード REST APIは、HTTP Basic認証を使用してプロジェクトデータを読み取ります。ユーザー名としてプロジェクトのAPIキーを使用し、パスワードとしてシークレットキーを使用します。シークレットキーはサーバに保管してください。
api_key:secret_keyをbase64でエンコードした値を使って、Authorizationヘッダーを送信します。
Authorization: Basic <base64(api_key:secret_key)>
cURLでは、-uによってヘッダーが自動的に作成されます。
curl -u '{api_key}:{secret_key}' 'https://amplitude.com/api/2/export?start=20220101T00&end=20220101T01'
HTTP V2およびBatch Event Upload APIが、代わりにJSONリクエストボディにプロジェクトのAPIキーを含めます。シークレットキーは必要ありません。 他のAmplitude APIは異なる認証情報を使用できます。特定のAPIリファレンスの認証セクションに従ってください。
認証済みのリクエストが失敗した場合、エンドポイントのドキュメント化されたステータスコード、認証情報、およびプロジェクト地域のAPIホストを確認してください。キーをローテーションまたは無効化する手順については、APIキーとシークレットキーを管理するを参照してください。
APIキーとシークレットキーを確認する
AmplitudeプロジェクトのAPIキーとシークレットキーを見つけるには:
- Amplitudeウェブアプリで、左下のナビゲーションにある**[設定]**を選択します。
- サイドナビゲーションで**[プロジェクト]**を選択します。
- 必要なキーを有するプロジェクトを選択します。プロジェクトの_[全般]_タブで、_APIキー_または_シークレットキー_の横にある**[管理]**を選択し、各値を表示してコピーします。マネージャーおよび管理者は、APIキーの生成、コピー、無効化や、シークレットキーの生成を行うことができます。シークレットキーは、生成されてはじめてAmplitudeに表示されます。
キーの作成、ローテーション、無効化、削除に関する詳細については、「APIキーとシークレットキーの管理」を参照してください。Amplitudeで使用するキーやトークンに関するリファレンスはすべて「キーとトークン」を参照してください。
これは役に立ちましたか?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.