Lingxing
切换旧版

刊登管理 - 获取指定 productType 的 JSON Schema

POST/basicOpen/openapi/publish/manage/getProductType

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/openapi/publish/manage/getProductTypeHTTPSPOST1

请求参数

marketplaceIdstring必填
市场ID
productTypeOriginstring必填
商品原始类型
store_idstring
店铺id。
刊登低价商店商品时必传，传入后将返回低价商店专用的JSON Schema。
刊登主站商品时请勿传该参数。
传入时 marketplaceId 必须为 ATVPDKIKX0DER，否则报错：仅美国站支持刊登低价商店商品

请求示例

以下为低价商店商品请求示例，刊登主站商品时请勿传 store_id。

{
    "marketplaceId": "ATVPDKIKX0DER",
    "productTypeOrigin": "ADVERTISEMENT_COLLECTIBLES",
    "store_id": "12345"
}

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/openapi/publish/manage/getProductType?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{"marketplaceId":"ATVPDKIKX0DER","productTypeOrigin":"ADVERTISEMENT_COLLECTIBLES","store_id":"12345"}'

返回结果

codenumber必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
示例 []
request_idstring必填
请求链路id
示例 b1d0217888784ce597131ff1c3fdbd2b.1753351351953
response_timestring必填
响应时间
示例 2025-07-24 18:02:34
dataobject必填
响应数据
隐藏子属性
productTypeobject必填
商品分类信息
隐藏子属性
productTypeUniqueIdstring必填
商品类型唯一id
示例 514829689877954560
marketplaceIdstring必填
市场id
示例 xxxxxxxxxxxxxxxx
productTypeOriginstring必填
商品类型
示例 ADVERTISEMENT_COLLECTIBLES
displayNamestring必填
商品类型名称
示例 ADVERTISEMENT_COLLECTIBLES
propertiesstring必填
商品类型的JSON Schema(站点语言版本)
propertiesZhstring必填
商品类型的JSON Schema(中文版本)
totalnumber必填
示例 0

返回成功示例

{
  "code": 0,
  "message": "success",
  "error_details": [],
  "request_id": "b1d0217888784ce597131ff1c3fdbd2b.1753351351953",
  "response_time": "2025-07-24 18:02:34",
  "data": {
    "productType": {
      "productTypeUniqueId": "514829689877954560",
      "productType": "advertisementcollectibles",
      "marketplaceId": "xxxxxxxxxxxxxxxx",
      "name": "ADVERTISEMENT_COLLECTIBLES",
      "displayName": "ADVERTISEMENT_COLLECTIBLES",
      "propertyGroups": "",
      "properties": "",
      "propertiesZh": ""
    }
  },
  "total": 0
}