메인 콘텐츠로 건너뛰기

​
개요

콘솔 [관리] > [연동] 메뉴에서는 Adrop 외부 연동에 필요한 설정을 모두 관리합니다.
  • API 키: Open API 호출, 리워드 광고 SSV 콜백 복호화에 사용
  • 리워드 광고 SSV: 보상 완료 시 서버로 전송되는 콜백 URL 설정 — 리워드 광고 SSV 문서 참고
연동 메뉴는 프로젝트 소유자(owner) 권한이 있는 멤버만 접근할 수 있어요.

​
API 키 발급

1

연동 메뉴 이동

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

키 정보 입력

API 키 섹션에서 [API 키 생성] 버튼을 클릭하고 아래 정보를 입력합니다.
항목설명
키 이름용도를 식별할 수 있는 이름 (예: “리포트 연동”). 1자 이상 입력.
Scope1개 이상 선택 필수. 허용된 권한 범위만 호출 가능.
3

키 복사 및 보관

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

​
권한 범위 (Scope)

권한설명
report:read캠페인 리포트 및 백필 수익 데이터 조회
campaign:read캠페인 정보 조회
campaign:write캠페인 생성 및 수정
webhook:read웹훅 콜백 데이터 조회
webhook:write웹훅 이벤트 전송
auth:delegate위임 인증 코드 생성
현재 Open API로 호출 가능한 엔드포인트는 리포트 API입니다. 권한 목록은 콘솔에 따라 일부만 노출될 수 있어요.

​
Open API 호출

​
기본 정보

항목값
Base URLhttps://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로 조회하는 방법