> ## 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](/ko/integrations/ssv) 문서 참고

연동 메뉴는 프로젝트 **소유자(owner)** 권한이 있는 멤버만 접근할 수 있어요.

***

## API 키 발급

<Steps>
  <Step title="연동 메뉴 이동">
    콘솔 **\[관리]** > **\[연동]** 메뉴로 이동합니다.
  </Step>

  <Step title="키 정보 입력">
    **API 키** 섹션에서 **\[API 키 생성]** 버튼을 클릭하고 아래 정보를 입력합니다.

    | 항목        | 설명                                       |
    | --------- | ---------------------------------------- |
    | **키 이름**  | 용도를 식별할 수 있는 이름 (예: "리포트 연동"). 1자 이상 입력. |
    | **Scope** | 1개 이상 선택 필수. 허용된 권한 범위만 호출 가능.           |
  </Step>

  <Step title="키 복사 및 보관">
    생성된 API 키를 복사하여 안전하게 보관합니다.

    <Warning>
      API 키는 생성 직후 **1회만** 확인할 수 있습니다. 창을 닫으면 다시 조회할 수 없으니, 반드시 복사하여 안전한 곳에 보관하세요.
    </Warning>
  </Step>
</Steps>

### 권한 범위 (Scope)

| 권한               | 설명                     |
| ---------------- | ---------------------- |
| `report:read`    | 캠페인 리포트 및 백필 수익 데이터 조회 |
| `campaign:read`  | 캠페인 정보 조회              |
| `campaign:write` | 캠페인 생성 및 수정            |
| `webhook:read`   | 웹훅 콜백 데이터 조회           |
| `webhook:write`  | 웹훅 이벤트 전송              |
| `auth:delegate`  | 위임 인증 코드 생성            |

<Note>
  현재 Open API로 호출 가능한 엔드포인트는 [리포트 API](/ko/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`)만 표시, 나머지는 마스킹 |
| **Scope** | 부여된 권한 개수 (툴팁으로 전체 확인)                |
| **생성일**   | 키가 생성된 날짜                             |

### 키 폐기

더 이상 사용하지 않는 키는 우측 메뉴의 \*\*\[폐기]\*\*로 즉시 폐기할 수 있습니다.

<Warning>
  폐기된 API 키는 즉시 인증이 차단됩니다. 해당 키를 사용 중인 시스템에서 API 호출이 실패할 수 있으니, 폐기 전에 연동 중인 서비스가 없는지 확인하세요.
</Warning>

<Note>
  **리워드 광고 SSV**에 연결된 API 키는 폐기할 수 없어요. SSV에서 다른 API 키로 변경하거나 SSV 설정을 삭제한 뒤 다시 시도하세요.
</Note>

***

## 관련 문서

<CardGroup cols={2}>
  <Card title="리워드 광고 SSV" icon="shield-check" href="/ko/integrations/ssv">
    보상 완료 시 서버로 전송되는 SSV 콜백 URL 등록 및 페이로드 복호화
  </Card>

  <Card title="리포트 API" icon="chart-line" href="/ko/integrations/reports">
    캠페인 성과 및 백필 수익 데이터를 API로 조회하는 방법
  </Card>
</CardGroup>