Publisher API (Metadata)

URL

• https://sspi-ext-report.adpopcorn.com/v1/metadata/publisher/media

Method

• GET

Request Headers

Name	Type	Value	필수	설명
Authorization	string	Bearer ${access_token}	Y	생성된 액세스 토큰을 ${access_token} 자리에 넣어 인증에 사용하세요.

$ curl "https://sspi-ext-report.adpopcorn.com/v1/metadata/publisher/media?page=1" -H "Authorization: Bearer test_access_token" -L

Parameter

Parameter	Type	필수	설명
page	int	Y	출력할 페이지 수(default: 1)
pageSize	int	Y	페이지 당 들어갈 레코드 수(default: 50)
sortBy	string	N	기본적으로 정렬 순서는 오름차순입니다. 내림차순으로 변경하려면 요청한 필드 앞에 마이너스 기호를 붙이세요. 예시: sortBy=-media_key,placement_id

Content-Type

• application/json

Response parameter

Body parameter	Type	설명
alert	string	서버에서 전송된 알림 메시지. 대부분의 경우 null일 것입니다. 예시: "alert": null
page	int	출력할 페이지 수
page_size	int	페이지 당 노출될 record 수
page_count	int	전체 페이지 수
total_record_count	int	전체 레코드 개수
records	Array of Media	리포트 데이터

Media

ID	Type	설명
key	string	매체 키
name	string	매체 명
type	int	1: iOS, 2: Android
status	int	상태 (10: 활성화, 30: 비활성화)
placements	Array of Placement	플레이스먼트 데이터

Placements

ID	Type	설명
id	string	플레이스먼트 ID
name	string	플레이스먼트 이름
status	int	상태 (10: 활성화, 30: 비활성화)
campaign_type	int	광고 타입(1: 배너, 2: 전면, 3: 전면 비디오, 4: 네이티브). 앱 매체 한정.
size	string	광고 사이즈(campaign_type =1 or 2 이거나 웹 매체 한정)

200

json

{
	"alert": null,
	"page": 1,
	"page_size": 50,
	"page_count": 2,
	"total_record_count": 71,
	"records": [
		{
			"key": "test_media_key",
			"name": "test_media_name",
			"status": 10,
			"placements": [
				{
						"id": "test_placement_id",
						"name": "test_placement_name",
						"status": 10,
						"campaign_type": 1,
						"size": "728x90"
				}
			]
		}
	]
}

서버 응답 코드

아래 표는 Adpopcorn API 플랫폼에서 REST API 응답으로 전송되는 일반적인 HTTP 상태 코드를 나열한 것입니다.

Code	메세지	설명
200	성공	요청이 성공적으로 처리되었습니다.
400	client-side 에러	유효성 검사에 실패했습니다.
401	인증되지 않음	인증 또는 권한 부여 실패가 발생했습니다.
500	API-side 에러	Adpopcorn API 플랫폼에 문제가 발생했습니다.