> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adrop.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 連携 & APIキー

> コンソールの[管理] > [連携]メニューでAPIキーを発行・管理し、外部連携を設定する方法をご案内します。

## 概要

コンソールの\*\*\[管理]\*\* > \*\*\[連携]\*\*メニューでは、Adrop外部連携に必要な設定をすべて管理します。

* **APIキー**: Open API呼び出し、リワード広告SSVコールバックの復号に使用
* **リワード広告SSV**: 報酬完了時にサーバーへ送信されるコールバックURLの設定 — [リワード広告SSV](/ja/integrations/ssv)ドキュメントを参照

連携メニューは、プロジェクトの\*\*オーナー（owner）\*\*権限を持つメンバーのみアクセスできます。

***

## APIキーの発行

<Steps>
  <Step title="連携メニューへ移動">
    コンソールの\*\*\[管理]\*\* > \*\*\[連携]\*\*メニューに移動します。
  </Step>

  <Step title="キー情報の入力">
    **APIキー**セクションで\*\*\[APIキーを作成]\*\*ボタンをクリックし、以下の情報を入力します。

    | 項目       | 説明                                     |
    | -------- | -------------------------------------- |
    | **キー名**  | 用途を識別できる名前（例：「レポート連携」）。1文字以上を入力してください。 |
    | **スコープ** | 1つ以上の選択が必須です。許可された権限の範囲のみ呼び出せます。       |
  </Step>

  <Step title="キーのコピーと保管">
    生成されたAPIキーをコピーし、安全に保管します。

    <Warning>
      APIキーは生成直後に**1回だけ**確認できます。ウィンドウを閉じると再表示できないため、必ずコピーして安全な場所に保管してください。
    </Warning>
  </Step>
</Steps>

### 権限範囲（Scope）

| 権限               | 説明                          |
| ---------------- | --------------------------- |
| `report:read`    | キャンペーンレポートおよびバックフィル収益データの照会 |
| `campaign:read`  | キャンペーン情報の閲覧                 |
| `campaign:write` | キャンペーンの作成・変更                |
| `webhook:read`   | Webhookコールバックデータの閲覧         |
| `webhook:write`  | Webhookイベントの送信              |
| `auth:delegate`  | 委任認証コードの作成                  |

<Note>
  現在Open APIで呼び出し可能なエンドポイントは[レポートAPI](/ja/integrations/reports)です。権限の一覧はコンソールによって一部のみ表示される場合があります。
</Note>

***

## Open API呼び出し

### 基本情報

| 項目       | 値                        |
| -------- | ------------------------ |
| Base URL | `https://lake.adrop.io`  |
| プロトコル    | HTTPS                    |
| 認証方式     | API Key（`x-api-key`ヘッダー） |

### 認証

すべてのAPIリクエストに`x-api-key`ヘッダーを含める必要があります。

```bash theme={null}
curl -X POST https://lake.adrop.io/report \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{...}'
```

<Warning>
  APIキーは外部に共有しないでください。キーが漏洩した場合は、直ちに廃棄して新しいキーを発行してください。
</Warning>

***

## APIキーの管理

### キー一覧の確認

**連携**メニューの**APIキー**セクションで、発行済みのAPIキー一覧を確認できます。

| 表示項目      | 説明                                  |
| --------- | ----------------------------------- |
| **キー名**   | キー作成時に入力した名前                        |
| **APIキー** | prefix（例：`adrop_7kF2`）のみ表示、以降はマスキング |
| **スコープ**  | 付与された権限の数（ツールチップで全体を確認）             |
| **作成日**   | キーが作成された日付                          |

### キーの廃棄

使用しなくなったキーは、右側メニューの\*\*\[取り消し]\*\*で即座に廃棄できます。

<Warning>
  廃棄されたAPIキーは即座に認証がブロックされます。そのキーを使用中のシステムでAPI呼び出しが失敗する可能性がありますので、廃棄前に連携中のサービスがないか確認してください。
</Warning>

<Note>
  **リワード広告SSV**に連携されたAPIキーは廃棄できません。SSVで別のAPIキーに変更するか、SSV設定を削除してから再度お試しください。
</Note>

***

## 関連ドキュメント

<CardGroup cols={2}>
  <Card title="リワード広告SSV" icon="shield-check" href="/ja/integrations/ssv">
    報酬完了時にサーバーへ送信されるSSVコールバックURLの登録とペイロードの復号
  </Card>

  <Card title="レポートAPI" icon="chart-line" href="/ja/integrations/reports">
    キャンペーン成果およびバックフィル収益データをAPIで照会する方法
  </Card>
</CardGroup>