> ## 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 없이 서버 사이드에서 직접 광고를 요청할 수 있습니다. 웹 서버, 백엔드 서비스, 또는 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 | 로케일 (예: `ko_KR`, `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="/ko/sdk/rest-api/banner">
    HTML 형식으로 반환되어 웹에서 직접 렌더링 가능
  </Card>

  <Card title="네이티브 광고" icon="puzzle-piece" href="/ko/sdk/rest-api/native">
    구조화된 데이터로 반환되어 커스텀 UI 구현 가능
  </Card>
</CardGroup>

***

## 관련 문서

<CardGroup cols={2}>
  <Card title="타겟팅 설정" icon="bullseye" href="/ko/sdk/rest-api/targeting">
    사용자 속성 및 문맥 타겟팅 설정
  </Card>

  <Card title="이벤트 전송" icon="chart-line" href="/ko/sdk/rest-api/event">
    사용자 행동 이벤트 전송 및 전환 추적
  </Card>

  <Card title="에러 코드" icon="triangle-exclamation" href="/ko/sdk/rest-api/errors">
    API 에러 코드 및 해결 방법
  </Card>
</CardGroup>