app이 어느 앱인지 확인할 때 사용합니다.
앱은 API로 만들거나 수정·삭제할 수 없습니다. 앱 등록과 관리는 콘솔에서 하세요. 앱 관리하기를 참고하세요.
사전 준비
app:read권한(scope)이 있는 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로 알려 줍니다.