エクスポートアナリティクス 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 キーをローテーションする必要がある場合は、以下の手順に従ってください。

  1. Settings → GeneralGenerate new key をクリックし、古いキーの横にあるゴミ箱アイコンをクリックします。
  2. アプリで使用しているキーを更新します。

次のステップ:リクエスト: