商品详情 API

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

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

请求体

字段必填说明
channel1688 | taobao | weidian
product_id二选一1688 offerId;淘宝优先 mi_id,其次旧版 item_id
url二选一商品页 URL
mi_id淘宝TaoWorld 商品 ID(下单推荐)
tao_password淘宝淘宝分享口令 — 粘贴完整分享文案或口令字符串
language默认 en
response_formatstandard(默认)或 upstream

示例

淘宝口令:

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

1688 offer id:

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

响应

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

规格选择

基于 product.variants[] 构建结账 UI — 见 集成模式