쿠팡 API - Product list

?????? 이건 뭘 하는 API 인지?

URL

  • https://sspi-ext-report.adpopcorn.com/v1/metadata/coupang/products

Method

  • GET

Request Headers

NameTypeValue필수설명

Authorization

string

Bearer ${access_token}

Y

생성된 액세스 토큰을 ${access_token} 자리에 넣어 인증에 사용하세요.

예시 : curl “https://sspi-ext-report.adpopcorn.com/v1/metadata/coupang/products?page=1” -H “Authorization: Bearer test_access_token” -L

Parameter

ParameterType필수설명

page

int

N

표시된 페이지 수 (default: 1)

pageSize

int

N

페이지 당 노출될 record 수 (default: 50)

sortBy

string

N

기본적으로 정렬 순서는 오름차순입니다. 내림차순으로 변경하려면 요청한 필드 앞에 마이너스 기호를 붙이세요. 예시: sortBy=-category_id,product_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 object

리포트 데이터

IDType설명

category_id

numeric

카테고리 아이디

category_name

string

카테고리 이름

is_rocket

Boolean

로켓배송 여부

is_free_shipping

Boolean

무료 배송 여부

product_id

string

제품 ID

product_name

string

제품 이름

product_price

numeric

제품 가격

product_url

string

제품 URL

product_image

string

제품 이미지

json
{
	"alert": null,
	"page": 1,
	"page_size": 50,
	"page_count": 2,
	"total_record_count": 71,
	"records": [
		{
			"category_id": 1,
			"category_name": "test category",
			"is_rocket": false,
			"is_free_shipping": false,
			"product_id": "test product id 1",
			"product_name": "test product name 1",
			"product_price": 18170,
			"product_url": "<coupang link>",
			"product_image": "<coupang product image url>"
		},
		{
			"category_id": 1,
			"category_name": "test category",
			"is_rocket": false,
			"is_free_shipping": false,
			"product_id": "test product id 2",
			"product_name": "test product name 2",
			"product_price": 31300,
			"product_url": "<coupang link>",
			"product_image": "<coupang product image url>"
	  }
	]
}

서버 응답 코드

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

Code메세지설명

200

성공

요청이 성공적으로 처리되었습니다.

400

client-side 에러

유효성 검사에 실패했습니다.

401

인증되지 않음

인증 또는 권한 부여 실패가 발생했습니다.

500

API-side 에러

Adpopcorn API 플랫폼에 문제가 발생했습니다.

Last updated