エクスポートアナリティクス API の認証とリクエスト形式
認証
API リクエストの認証には、シークレット API キーを Authorization ヘッダーとして使用します。キーは App Settings で確認できます。形式は Api-Key {YOUR_SECRET_API_KEY} で、例として Api-Key secret_live_... のように指定します。
API キーはアプリごとに固有です。複数のアプリをお持ちの場合は、それぞれ異なるキーを使用してください。
リクエスト形式
ヘッダー
サーバーサイド API リクエストには、特定のヘッダーと JSON ボディが必要です。以下の内容を参考にリクエストを構成してください。
| ヘッダー | 説明 |
|---|---|
| Content-Type | (必須)API がリクエストを処理するために application/json を指定します。 |
| Adapty-Tz | (任意)データのグループ化と表示に使用するタイムゾーンを設定します。IANA タイムゾーンデータベース形式(例: Europe/Berlin)を使用してください。 |
ボディ
API はリクエストに必要なデータを含む JSON 形式のボディを受け取ります。
レート制限
API キーごとに 1 秒あたり最大 2 リクエストまで送信できます。この制限を超えると 429 Too Many Requests エラーが返されます。
API キーのローテーション
シークレット API キーをローテーションする必要がある場合は、以下の手順に従ってください。
- Settings → General で Generate new key をクリックし、古いキーの横にあるゴミ箱アイコンをクリックします。
- アプリで使用しているキーを更新します。
次のステップ:リクエスト: