Product detail API
POST /v1/products/detail — fetch full product detail for checkout integration (SKU matrix, prices, stock).
Related: Product response models · Procurement mapping
Request body
| Field | Required | Description |
|---|---|---|
channel | Yes | 1688 | taobao | weidian |
product_id | One of | 1688 offerId; Taobao prefer mi_id over legacy item_id |
url | One of | Product page URL |
mi_id | Taobao | TaoWorld product id (recommended for orders) |
tao_password | Taobao | Taobao share口令 — paste the full share text or口令 string |
language | No | Default en |
response_format | No | standard (default) or upstream |
Examples
Taobao口令:
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"
}Response
StandardProductDetail wrapped as { "product": { ... }, "request_id": "req_..." } — see Product response models.
Variant selection
Build checkout UI from product.variants[] — see integration pattern.