メインコンテンツへスキップ

​
概要

コンソールの**[管理]** > **[連携]**メニューでは、Adrop外部連携に必要な設定をすべて管理します。
  • APIキー: Open API呼び出し、リワード広告SSVコールバックの復号に使用
  • リワード広告SSV: 報酬完了時にサーバーへ送信されるコールバックURLの設定 — リワード広告SSVドキュメントを参照
連携メニューは、プロジェクトの**オーナー（owner）**権限を持つメンバーのみアクセスできます。

​
APIキーの発行

1

連携メニューへ移動

コンソールの**[管理]** > **[連携]**メニューに移動します。
2

キー情報の入力

APIキーセクションで**[APIキーを作成]**ボタンをクリックし、以下の情報を入力します。
項目説明
キー名用途を識別できる名前（例：「レポート連携」）。1文字以上を入力してください。
スコープ1つ以上の選択が必須です。許可された権限の範囲のみ呼び出せます。
3

キーのコピーと保管

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

​
権限範囲（Scope）

権限説明
report:readキャンペーンレポートおよびバックフィル収益データの照会
campaign:readキャンペーン情報の閲覧
campaign:writeキャンペーンの作成・変更
webhook:readWebhookコールバックデータの閲覧
webhook:writeWebhookイベントの送信
auth:delegate委任認証コードの作成
現在Open APIで呼び出し可能なエンドポイントはレポートAPIです。権限の一覧はコンソールによって一部のみ表示される場合があります。

​
Open API呼び出し

​
基本情報

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

​
認証

すべてのAPIリクエストにx-api-keyヘッダーを含める必要があります。 
curl -X POST https://lake.adrop.io/report \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{...}'
APIキーは外部に共有しないでください。キーが漏洩した場合は、直ちに廃棄して新しいキーを発行してください。

​
APIキーの管理

​
キー一覧の確認

連携メニューのAPIキーセクションで、発行済みのAPIキー一覧を確認できます。
表示項目説明
キー名キー作成時に入力した名前
APIキーprefix（例：adrop_7kF2）のみ表示、以降はマスキング
スコープ付与された権限の数（ツールチップで全体を確認）
作成日キーが作成された日付

​
キーの廃棄

使用しなくなったキーは、右側メニューの**[取り消し]**で即座に廃棄できます。
廃棄されたAPIキーは即座に認証がブロックされます。そのキーを使用中のシステムでAPI呼び出しが失敗する可能性がありますので、廃棄前に連携中のサービスがないか確認してください。
リワード広告SSVに連携されたAPIキーは廃棄できません。SSVで別のAPIキーに変更するか、SSV設定を削除してから再度お試しください。

​
関連ドキュメント

リワード広告SSV

報酬完了時にサーバーへ送信されるSSVコールバックURLの登録とペイロードの復号

レポートAPI

キャンペーン成果およびバックフィル収益データをAPIで照会する方法