쿠팡 API - Product list

URL

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

Method

• GET

Request Headers

Name	Type	Value	필수	설명
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

Parameter	Type	필수	설명
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 parameter	Type	설명
alert	string	서버에서 전송된 알림 메시지. 대부분의 경우 null일 것입니다. 예시: "alert": null
page	int	출력할 페이지 수
page_size	int	페이지 당 노출될 record 수
page_count	int
total_record_count	int
records	Array of object	리포트 데이터

ID	Type	설명
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	제품 이미지

200

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