商品详情 API
POST /v1/products/detail — 获取完整商品详情,用于结账集成(SKU 矩阵、价格、库存)。
请求体
| 字段 | 必填 | 说明 |
|---|---|---|
channel | 是 | 1688 | taobao | weidian |
product_id | 二选一 | 1688 offerId;淘宝优先 mi_id,其次旧版 item_id |
url | 二选一 | 商品页 URL |
mi_id | 淘宝 | TaoWorld 商品 ID(下单推荐) |
tao_password | 淘宝 | 淘宝分享口令 — 粘贴完整分享文案或口令字符串 |
language | 否 | 默认 en |
response_format | 否 | standard(默认)或 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 — 见 集成模式。