Skip to main content

​
개요

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

​
API 키 발급

1

연동 메뉴 이동

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

키 정보 입력

API 키 섹션에서 [API 키 생성] 버튼을 클릭하고 아래 정보를 입력합니다.
프로젝트당 활성 API 키는 최대 10개까지 발급할 수 있어요. 한도에 도달했다면 사용하지 않는 키를 폐기한 뒤 새로 발급하세요.
3

키 복사 및 보관

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

​
권한 범위 (Scope)

현재 Open API로 호출할 수 있는 API는 리포트 API, 문맥 타겟팅 API, 캠페인 예약 Webhook입니다. 문맥 타겟팅 API를 쓰려면 context-targeting:read와 context-targeting:write를, 캠페인 예약 Webhook을 쓰려면 campaign:read와 campaign:subscribe를 모두 부여하세요. context-targeting:read, context-targeting:write, campaign:subscribe는 키를 만들 때 기본으로 선택되어 있지 않으므로 직접 선택하세요.

​
Open API 호출

​
기본 정보

​
인증

모든 API 요청에 x-api-key 헤더를 포함해야 합니다.
API 키는 외부에 공유하지 마세요. 키가 노출된 경우 즉시 폐기하고 새 키를 발급하세요.

​
API 키 관리

​
키 목록 조회

연동 메뉴의 API 키 섹션에서 발급된 API 키 목록을 확인할 수 있습니다.

​
권한 범위 변경

발급한 API 키의 권한 범위(Scope)는 변경할 수 없습니다. 필요한 권한으로 새 키를 발급하고, 연동 중인 서비스를 새 키로 바꾼 뒤 기존 키를 폐기하세요.

​
키 폐기

더 이상 사용하지 않는 키는 우측 메뉴의 **[폐기]**로 즉시 폐기할 수 있습니다.
폐기된 API 키는 즉시 인증이 차단됩니다. 해당 키를 사용 중인 시스템에서 API 호출이 실패할 수 있으니, 폐기 전에 연동 중인 서비스가 없는지 확인하세요.
리워드 광고 SSV에 연결된 API 키는 폐기할 수 없어요. SSV에서 다른 API 키로 변경하거나 SSV 설정을 삭제한 뒤 다시 시도하세요.

​
관련 문서

리워드 광고 SSV

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

리포트 API

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

문맥 타겟팅 API

서버에서 문맥 타겟팅 옵션과 컨텍스트 ID를 관리하는 방법

캠페인 예약 Webhook

예약된 캠페인의 변경을 받고 조회하는 방법