Skip to main content
앱 API로 프로젝트에 등록된 앱을 조회할 수 있습니다. 광고 유닛 API로 유닛을 만들 때 넣을 앱 ID를 찾거나, 유닛의 app이 어느 앱인지 확인할 때 사용합니다.
앱은 API로 만들거나 수정·삭제할 수 없습니다. 앱 등록과 관리는 콘솔에서 하세요. 앱 관리하기를 참고하세요.

사전 준비

  • app:read 권한(scope)이 있는 API 키가 필요합니다. 이 권한은 콘솔 [관리] > [연동] 메뉴에서 선택할 수 없습니다. 에이드랍에 요청하면 권한을 넣은 키를 발급해 드리며, 광고 유닛 API와 광고 상품 API 권한도 같은 키에 함께 받을 수 있습니다.
API는 서버에서만 호출하세요. 앱이나 웹 페이지에 API 키를 넣지 마세요.

기본 정보


엔드포인트

경로는 Base URL 기준입니다.

앱 객체

SDK 초기화에 쓰는 앱 키 같은 설정 정보는 응답에 포함되지 않습니다.

앱 목록 조회

프로젝트의 앱을 페이지 단위로 반환합니다. 정렬 순서는 대체로 등록한 순서이지만, 오래된 앱은 순서가 다를 수 있습니다. 순서에 기대지 말고 next로 이어서 읽으세요.

요청

app:read 권한이 필요합니다.

쿼리 파라미터

요청 예시

응답 예시

200 응답으로 items(앱 목록)와 next(다음 페이지 커서)를 반환합니다. next가 없으면 마지막 페이지입니다.

앱 조회

앱 하나를 반환합니다.

요청

app:read 권한이 필요합니다.

요청 예시

응답

200 응답으로 앱 객체를 반환합니다.

오류

  • 404 PROJECT_APP_NOT_FOUND: 앱이 없거나 다른 프로젝트의 앱입니다.

오류 처리

오류 응답에는 statusCode가 들어 있고, 아래 표에서 errorCode 칸이 -가 아닌 오류에는 errorCode도 들어 있습니다. 처리 방식은 errorCode로 나누고, errorCode가 없으면 statusCode로 나누세요. 요청 형식 오류(VALIDATION_FAILED)는 잘못된 위치를 detail.errors[]의 path로 알려 줍니다.