> ## 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.

# REST API

> Adrop REST APIを使用してサーバーサイドで広告をリクエストする方法を案内します。

## 概要

Adrop REST APIを使用すると、SDKなしでサーバーサイドから直接広告をリクエストできます。Webサーバー、バックエンドサービス、またはSDKをサポートしていないプラットフォームで広告を連携する際に便利です。

## 基本情報

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

***

## 認証設定

APIを使用するにはApp Keyが必要です。

### App Keyの取得

1. [Adropコンソール](https://console.adrop.io)にログイン
2. **管理**タブに移動
3. **アプリ**メニューからプラットフォーム別の`adrop_service.json`をダウンロード
4. JSONファイルでApp Keyを確認

### 認証ヘッダー

すべてのAPIリクエストに`Authorization`ヘッダーを含める必要があります：

```
Authorization: YOUR_APP_KEY
```

<Warning>
  App Keyは外部に共有しないでください。
</Warning>

***

## 共通パラメータ

### 必須パラメータ

| パラメータ  | タイプ    | 説明       |
| ------ | ------ | -------- |
| `unit` | STRING | 広告ユニットID |

### 推奨パラメータ

| パラメータ | タイプ    | 説明                              |
| ----- | ------ | ------------------------------- |
| `uid` | STRING | ユーザー固有識別子                       |
| `pf`  | STRING | プラットフォーム（`android`、`ios`、`web`） |
| `lcl` | STRING | ロケール（例：`ja_JP`、`en_US`）         |

### 任意パラメータ

| パラメータ       | タイプ    | 説明                     |
| ----------- | ------ | ---------------------- |
| `theme`     | STRING | テーマモード（`light`、`dark`） |
| `adId`      | STRING | 広告識別子（ADID/IDFA）       |
| `contextId` | STRING | コンテキストターゲティングID        |

<Note>
  `uid`パラメータは、ユーザーごとの広告表示頻度制御とターゲティング情報のマッピングに使用されます。提供しない場合、正確なターゲティングが難しくなる可能性があります。
</Note>

***

## サポートされている広告フォーマット

<CardGroup cols={2}>
  <Card title="バナー広告" icon="rectangle-ad" href="/ja/sdk/rest-api/banner">
    HTML形式で返され、Webで直接レンダリング可能
  </Card>

  <Card title="ネイティブ広告" icon="puzzle-piece" href="/ja/sdk/rest-api/native">
    構造化データで返され、カスタムUI実装が可能
  </Card>
</CardGroup>

***

## 関連ドキュメント

<CardGroup cols={2}>
  <Card title="ターゲティング設定" icon="bullseye" href="/ja/sdk/rest-api/targeting">
    ユーザー属性およびコンテキストターゲティング設定
  </Card>

  <Card title="イベント送信" icon="chart-line" href="/ja/sdk/rest-api/event">
    ユーザー行動イベントの送信およびコンバージョントラッキング
  </Card>

  <Card title="エラーコード" icon="triangle-exclamation" href="/ja/sdk/rest-api/errors">
    APIエラーコードと解決方法
  </Card>
</CardGroup>