商品详情 API

POST /v1/products/detail — 获取完整商品详情，用于结账集成（SKU 矩阵、价格、库存）。

相关文档：商品响应模型 · 采购字段映射

请求体

字段必填说明
channel是1688 | taobao | weidian
id条件搜索返回的 id 可直接回传。淘宝 = mi_id；1688 = offerId
product_id条件1688 offerId；淘宝为原数字 item_id
url条件商品页 URL
mi_id淘宝条件与淘宝 id 等价
tao_password淘宝条件淘宝分享口令 — 粘贴完整分享文案或口令字符串
language否默认 en
response_format否standard（默认）或 upstream

请把搜索返回的 id 回传到 id。不要把淘宝 id 塞进 product_id，那边会当数字 item_id。

淘宝 id / mi_id 会周期性变化。 请勿长期缓存，否则详情、相似推荐和下单 lines[].id 可能失败。下单前请重新搜索或拉详情。

示例

淘宝 id（与搜索 id / mi_id 相同）：

POST /v1/products/detail
{
  "channel": "taobao",
  "id": "0000Z-4oyqr-mVcYGcXO2JuqXweqkWsUCCNOt5pXct7_TgY",
  "language": "en"
}

淘宝口令：

POST /v1/products/detail
{
  "channel": "taobao",
  "tao_password": "￥abc123￥ 复制这条信息...",
  "language": "en"
}

1688 id（与搜索 id / offerId 相同）：

POST /v1/products/detail
{
  "channel": "1688",
  "id": "554456348334",
  "language": "en"
}

响应

StandardProductDetail，包装为 { "product": { ... }, "request_id": "req_..." } — 见 商品响应模型。

规格选择

基于 product.variants[] 构建结账 UI — 见 集成模式。匹配规格时优先使用 prop_id + value_id（淘宝）或 prop_id（1688）。

获取支持

需要集成帮助？请联系开发者支持 support@hiobuy.com · 预计 1–2 个工作日内回复

发送邮件