---
title: エクスポートアナリティクス API の認証とリクエスト形式
---

## 認証 \{#authorization\}

API リクエストの認証には、シークレット API キーを Authorization ヘッダーとして使用します。キーは [App Settings](https://app.adapty.io/settings/general) で確認できます。形式は `Api-Key {YOUR_SECRET_API_KEY}` で、例として `Api-Key secret_live_...` のように指定します。

:::important
API キーはアプリごとに固有です。複数のアプリをお持ちの場合は、それぞれ異なるキーを使用してください。
:::

## リクエスト形式 \{#request-format\}

**ヘッダー**

サーバーサイド API リクエストには、特定のヘッダーと JSON ボディが必要です。以下の内容を参考にリクエストを構成してください。

| ヘッダー     | 説明                                                         |
| ------------ | ------------------------------------------------------------ |
| Content-Type | （必須）API がリクエストを処理するために `application/json` を指定します。 |
| Adapty-Tz    | （任意）データのグループ化と表示に使用するタイムゾーンを設定します。[IANA タイムゾーンデータベース形式](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)（例: `Europe/Berlin`）を使用してください。 |

## ボディ \{#body\}

API はリクエストに必要なデータを含む JSON 形式のボディを受け取ります。

## レート制限 \{#rate-limits\}

API キーごとに 1 秒あたり最大 2 リクエストまで送信できます。この制限を超えると `429 Too Many Requests` エラーが返されます。

## API キーのローテーション \{#rotate-api-keys\}

シークレット API キーをローテーションする必要がある場合は、以下の手順に従ってください。

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

---

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

- [アナリティクスデータの取得](api-export-analytics/operations/retrieveAnalyticsData)
- [コホートデータの取得](api-export-analytics/operations/retrieveCohortData)
- [コンバージョンデータの取得](api-export-analytics/operations/retrieveConversionData)
- [ファネルデータの取得](api-export-analytics/operations/retrieveFunnelData)
- [LTV（ライフタイムバリュー）データの取得](api-export-analytics/operations/retrieveLTVData)
- [リテンションデータの取得](api-export-analytics/operations/retrieveRetentionData)