商品详情

获取淘宝或 1688 商品的完整信息，包括 SKU、图片、属性与描述。

POSThttps://open.hiobuy.com/api/client/third-purchase/info

若实际 API 基地址不同，请替换 `https://open.hiobuy.com`。

请求头

名称	必填	类型	说明
`X-Uuid`	是	string	商户 UUID（账户唯一标识）
`Language`	否	string	商品标题等信息的展示语言，默认 `zh_CN`。见支持的语言。

支持的语言

平台	代码	语言
淘宝	`zh_CN`	简体中文
淘宝	`en_US`	英语
淘宝	`vi_VN`	越南语
1688	`zh_CN`	简体中文
1688	`en_US`	英语
1688	`ko_KR`	韩语
1688	`ja`	日语
1688	`ru_RU`	俄语
1688	`vi_VN`	越南语
1688	`es_ES`	西班牙语
1688	`ar`	阿拉伯语

请求体

名称	必填	类型	说明
`keyword`	是	string	商品链接或平台商品 ID
`platform`	是	string	平台代码：`taobao`（淘宝）、`1688`（1688 批发网）
`use_platform`	否	string	是否使用 1688 平台原生字段返回：`0` 关闭，`1` 开启。仅 1688。详见 1688 接口说明

请求示例

{
  "keyword": "https://detail.1688.com/offer/930485860295.html",
  "platform": "1688"
}

也可将数字商品 ID 作为 keyword 传入（如 930485860295）。

响应示例

{
  "ret": 1,
  "msg": "success",
  "data": {
    "num_iid": 930485860295,
    "title": "Sexy Slit Evening Dress…",
    "title_cn": "开叉性感晚礼服包臀新款透视礼服长裙…",
    "orginal_price": "105.00",
    "price": "105.00",
    "max_price": "105.00",
    "skus": {
      "sku": [
        {
          "price": "105.00",
          "properties": "Color:White;Size:S",
          "quantity": 142,
          "sku_id": 5815062253431,
          "spec_id": "94d1d179497744028aa76873afdeba62"
        }
      ]
    },
    "shop_id": "BBBSelJAnz_oE-hYRZc-u-f2w"
  }
}

`desc` 为 HTML；示例中的 `sku` 列表可能已截断。

响应字段

顶层字段

名称	类型	说明
`ret`	number	状态码，`1` 表示成功
`msg`	string	状态说明
`data`	object	商品详情对象

`data`（商品）

名称	类型	说明
`num_iid`	integer	平台商品 ID
`title`	string	本地化标题
`title_cn`	string	中文标题
`orginal_price`	string	原价（接口字段名保留拼写）
`price`	string	现价
`max_price`	string	最高价
`price_pange_list`	object	1688 批发阶梯价（接口字段名保留拼写）
`min_order_quantity`	string	1688 起订量
`batch_number`	string	1688 批次数量
`nick`	string	卖家标识（1688 可能为脱敏编码）
`detail_url`	string	商品详情页链接
`pic_url`	string	主图 URL
`desc`	string	商品详情（HTML）
`item_imgs`	array	相册图片 URL 列表
`mainVideo`	string	主图视频 URL
`detailVideo`	string	详情视频 URL
`props`	array	扁平属性列表（`name`、`value`）
`props_img`	object	规格图映射（`属性:值` → URL）
`props_list`	array	本地化规格树（见下表）
`props_list_cn`	array	中文规格树
`skus`	object	SKU 列表容器
`tags`	array	商品标签（`key`、`name`、`value`）
`sales`	string	累计销量
`platform`	string	平台代码
`shop_id`	string	1688 店铺脱敏编码 — 可通过 shop-nick 接口查询显示名

`data.props_list[]`（规格树）

名称	类型	说明
`id`	string	主属性 ID（如 `Color`、`Size`）
`name`	string	主属性名称
`children`	array	子选项列表
`children[].id`	string	子属性 ID
`children[].name`	string	子属性名称

`data.skus.sku[]`（SKU）

名称	类型	说明
`orginal_price`	string	SKU 原价
`price`	string	SKU 现价
`properties`	string	规格键（`主属性ID:子属性ID;…`）
`properties_name`	string	规格键与展示名
`properties_cn`	string	中文规格键
`properties_name_cn`	string	中文规格键与展示名
`quantity`	integer	可售库存
`sales`	integer	SKU 销量
`sku_id`	integer	SKU ID
`spec_id`	string	1688 规格 ID
`total_price`	string	行合计（如有）

商品详情

请求头

支持的语言

请求体

请求示例

响应示例

响应字段

顶层字段

data（商品）

data.props_list[]（规格树）

data.skus.sku[]（SKU）

相关接口

`data`（商品）

`data.props_list[]`（规格树）

`data.skus.sku[]`（SKU）