---
title: "サーバーサイド API の認証とリクエスト形式"
description: ""
---

## 認証 \{#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 ボディが必要です。以下の詳細を参考にリクエストを構成してください。

| **ヘッダー**                  | **説明**                                                     |
| --------------------------- | ------------------------------------------------------------ |
| **adapty-profile-id**       | <p>ユーザーの Adapty プロファイル ID。[Adapty Dashboard -> **Profiles**](https://app.adapty.io/profiles/users) -> 特定のプロファイルページの **Adapty ID** フィールドで確認できます。</p><p>**adapty-customer-user-id** と互換性があり、どちらでも使用できます。</p> |
| **adapty-customer-user-id** | <p>あなたのシステムにおけるユーザー ID。[Adapty Dashboard -> **Profiles**](https://app.adapty.io/profiles/users) -> 特定のプロファイルページの **Customer user ID** フィールドで確認できます。</p><p>**adapty-profile-id** と互換性があり、どちらでも使用できます。</p><p>⚠️ Adapty SDK を使用してアプリコード内で<InlineTooltip tooltip="アプリ内でユーザーを識別する">[iOS](identifying-users)、[Android](android-identifying-users)、[React Native](react-native-identifying-users)、[Flutter](flutter-identifying-users)、[Unity](unity-identifying-users)</InlineTooltip>している場合にのみ機能します。</p> |
| **adapty-platform**         | （任意）アプリがインストールされているデバイスのプラットフォームを指定します。[Installation Meta](server-side-api-objects#installation-meta) オブジェクトを変更する [Create profile](api-adapty/operations/createProfile) および [Update profile](api-adapty/operations/updateProfile) リクエストでは、このパラメータを設定することを推奨します。これはユーザーが使用しているデバイスに依存し、1 人のユーザーが複数のデバイスを持つ場合があるためです。指定できる値: `iOS`、`macOS`、`iPadOS`、`visionOS`、`Android`、`web`。 |
| **Content-Type**            | API がリクエストを処理するために `application/json` に設定してください。 |

**ボディ**

API はリクエストに必要なデータを含む JSON 形式のボディを想定しています。

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

スロットリングを避けるために、（アプリごとの）リクエスト数を 1 分あたり 40,000 件以下に抑えてください。

この制限を超えると、すべてのユーザーに最適なパフォーマンスを維持するために、システムが低速化したり、リクエストが一時的にブロックされる場合があります。

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

シークレット API キーをローテーションする必要がある場合:

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

---

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

- [プロファイルの取得](api-adapty/operations/getProfile)
- [プロファイルの作成](api-adapty/operations/createProfile)
- [プロファイルの更新](api-adapty/operations/updateProfile)
- [プロファイルの削除](api-adapty/operations/deleteProfile)
- [アクセスレベルの付与](api-adapty/operations/grantAccessLevel)
- [アクセスレベルの取り消し](api-adapty/operations/revokeAccessLevel)
- [トランザクションの設定](api-adapty/operations/setTransaction)
- [購入の検証、顧客へのアクセスレベルの付与、およびトランザクション履歴のインポート](api-adapty/operations/validateStripePurchase)
- [ペイウォールの取得](api-adapty/operations/getPaywall)
- [ペイウォール一覧の取得](api-adapty/operations/listPaywalls)
- [ペイウォールの更新](api-adapty/operations/updatePaywall)