연동 & API 키 - Ad Control Help Center

개요

콘솔 [관리] > [연동] 메뉴에서는 Adrop 외부 연동에 필요한 설정을 모두 관리합니다.

API 키: Open API 호출, 리워드 광고 SSV 콜백 복호화에 사용
리워드 광고 SSV: 보상 완료 시 서버로 전송되는 콜백 URL 설정 — 리워드 광고 SSV 문서 참고

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

API 키 발급

연동 메뉴 이동

콘솔 [관리] > [연동] 메뉴로 이동합니다.

키 정보 입력

API 키 섹션에서 [API 키 생성] 버튼을 클릭하고 아래 정보를 입력합니다.

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

키 복사 및 보관

생성된 API 키를 복사하여 안전하게 보관합니다.

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

권한 범위 (Scope)

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

현재 Open API로 호출 가능한 엔드포인트는 리포트 API입니다. 권한 목록은 콘솔에 따라 일부만 노출될 수 있어요.

Open API 호출

기본 정보

항목	값
Base URL	`https://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`)만 표시, 나머지는 마스킹
Scope	부여된 권한 개수 (툴팁으로 전체 확인)
생성일	키가 생성된 날짜

키 폐기

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

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

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

리워드 광고 SSV

보상 완료 시 서버로 전송되는 SSV 콜백 URL 등록 및 페이로드 복호화

리포트 API

캠페인 성과 및 백필 수익 데이터를 API로 조회하는 방법

​개요

​API 키 발급

​권한 범위 (Scope)

​Open API 호출

​기본 정보

​인증

​API 키 관리

​키 목록 조회

​키 폐기

​관련 문서

리워드 광고 SSV

리포트 API

개요

API 키 발급

권한 범위 (Scope)

Open API 호출

기본 정보

인증

API 키 관리

키 목록 조회

키 폐기

관련 문서