商品 API 品类 API 品牌 API 运输 / 订单 API 退货 API 换货 API 促销 / 优惠券物流信息客服 / 咨询结算 CGF / CGF lite Rocket Growth

商品 API

GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/time-frame2609170000

商品列表范围查询

# 01

简介

商品列表范围查询

# 02

详细内容

API支持的买家用户地区：韩国, 台湾
基于注册商品列表的创建时间进行查看。
最长查看范围为10分钟。

路径

GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/time-frame

示例端点

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/time-frame?vendorId=A00012345&createdAtFrom=2020-02-19T10:43:30&createdAtTo=2020-02-19T10:50:30

URL API Name

GET_PRODUCTS_BY_TIME_FRAME

# 03

Query 参数

Name	Type	Description
vendorId*	string	卖家ID 酷澎分配给卖家的固有代码 ex) A00012345
createdAtFrom*	string	创建的开始时间格式"yyyy-MM-ddTHH:mm:ss" ex) 2016-12-28T06:20:00
createdAtTo*	string	创建的结束时间格式"yyyy-MM-ddTHH:mm:ss" 、ex) 2016-12-28T06:20:00

# 04

响应体

响应消息

Name

Type

Description

code

string

结果代码

SUCCESS/ERROR

message

string

结果信息

data

object[]

注册商品列表

查看的卖家商品个数，重复N次

sellerProductId

data[].sellerProductId

integer

注册商品ID

sellerProductName

data[].sellerProductName

string

注册商品名

搜索注册商品名，20字以内

displayCategoryCode

data[].displayCategoryCode

number

显示品类代码

vendorId

data[].vendorId

string

卖家ID

酷澎分配给卖家的固有代码

ex) A00012345

saleStartedAt

data[].saleStartedAt

string

销售开始时间

格式"yyyy-MM-ddTHH:mm:ss"

saleEndedAt

data[].saleEndedAt

string

销售结束时间

格式"yyyy-MM-ddTHH:mm:ss"

brand

data[].brand

string

品牌

输入正式的韩文/英文品牌名

statusName

data[].statusName

string

注册商品状态

Parameter Name	Status
IN_REVIEW	审核中
SAVED	临时保存
APPROVING	待审核
APPROVED	已通过审核
PARTIAL_APPROVED	部分通过审核
DENIED	审核不通过
DELETED	商品已删除

Parameter Name	Status
IN_REVIEW
SAVED
APPROVING
APPROVED
PARTIAL_APPROVED
DENIED
DELETED

createdAt

data[].createdAt

string

注册销售的时间

格式"yyyy-MM-ddTHH:mm:ss"

Response Example

{
  "code": "SUCCESS",
  "message": "",
  "data": [
    {
      "sellerProductId": 123,
      "sellerProductName": "[인xx] 컴퓨터잡지",
      "displayCategoryCode": null,
      "categoryId": 5555,
      "productId": 3333,
      "vendorId": "A0xxxxx",
      "mdId": "jxxx@",
      "mdName": "박xxx",
      "saleStartedAt": "2015-12-28T06:00:00",
      "saleEndedAt": "2099-01-01T00:00:00",
      "brand": null,
      "statusName": "승인완료",
      "createdAt": "2015-12-28T18:57:34"
    }
  ]
}

# 05

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
400	400 (check request parameter)	卖家[A0012345] 无法搜索其他卖家 [skma***] 的商品列表。	查看卖家 ID (vendorId) 是否输入正确。
400	400 (check request parameter)	超出搜索范围。最大范围为10 分钟。	查看输入的查询开始日期 (createdAtFrom) 和结束日期 (createdAtTo)是否正确。您最多可以在10 分钟内进行搜索。