Adrop Open API를 사용하면 콘솔에 직접 접속하지 않아도 캠페인 성과, 백필 수익 등 리포트 데이터를 API로 직접 조회할 수 있어요.
API를 사용하려면 먼저 콘솔에서 API 키를 발급받아야 합니다.
기본 정보
| 항목 | 값 |
|---|
| Base URL | https://lake.adrop.io |
| 프로토콜 | HTTPS |
| 인증 방식 | API Key (x-api-key 헤더) |
API 키 발급
콘솔에서 API 키를 생성하여 Open API에 접근할 수 있습니다.
키 생성하기
API 키 메뉴 이동
콘솔 [관리] > [API 키] 메뉴로 이동합니다.
키 정보 입력
[API 키 발급하기] 버튼을 클릭한 후 아래 정보를 입력합니다.| 항목 | 설명 |
|---|
| 키 이름 | 용도를 식별할 수 있는 이름 (예: “리포트 연동”) |
| 권한 범위 | 1개 이상 선택 필수. 현재 report:read 권한을 지원합니다. |
키 복사 및 보관
생성된 API 키를 복사하여 안전하게 보관합니다.API 키는 생성 직후 1회만 확인할 수 있습니다. 이후에는 다시 조회할 수 없으니, 반드시 복사하여 안전한 곳에 보관하세요.
권한 범위
API 키에 부여할 수 있는 권한 목록입니다.
| 권한 | 설명 |
|---|
report:read | 캠페인 리포트 및 백필 수익 데이터 조회 |
모든 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 키 | 일부 마스킹된 키 값 |
| 권한 범위 | 부여된 권한 목록 |
| 생성일 | 키가 생성된 날짜 |
키 폐기
더 이상 사용하지 않는 키는 [폐기] 버튼으로 즉시 폐기할 수 있습니다.
폐기된 API 키는 즉시 인증이 차단됩니다. 해당 키를 사용 중인 시스템에서 API 호출이 실패할 수 있으니, 폐기 전에 연동 중인 서비스가 없는지 확인하세요.
관련 문서
리포트 API
캠페인 성과 및 백필 수익 데이터를 API로 조회하는 방법
