Publisher API (Metadata)

URL

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

Method

  • GET

Request Headers

NameTypeValue필수설명

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

ParameterType필수설명

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 parameterType설명

alert

string

서버에서 전송된 알림 메시지. 대부분의 경우 null일 것입니다. 예시: "alert": null

page

int

출력할 페이지 수

page_size

int

페이지 당 노출될 record 수

page_count

int

전체 페이지 수

total_record_count

int

전체 레코드 개수

records

Array of Media

리포트 데이터

Media

IDType설명

key

string

매체 키

name

string

매체 명

type

int

1: iOS, 2: Android

status

int

상태 (10: 활성화, 30: 비활성화)

placements

Array of Placement

플레이스먼트 데이터

Placements

IDType설명

id

string

플레이스먼트 ID

name

string

플레이스먼트 이름

status

int

상태 (10: 활성화, 30: 비활성화)

campaign_type

int

광고 타입(1: 배너, 2: 전면, 3: 전면 비디오, 4: 네이티브). 앱 매체 한정.

size

string

광고 사이즈(campaign_type =1 or 2 이거나 웹 매체 한정)

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 플랫폼에 문제가 발생했습니다.

Last updated