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

FieldRequiredDescription
channelYes1688 | taobao | weidian
product_idOne of1688 offerId; Taobao prefer mi_id over legacy item_id
urlOne ofProduct page URL
mi_idTaobaoTaoWorld product id (recommended for orders)
tao_passwordTaobaoTaobao share口令 — paste the full share text or口令 string
languageNoDefault en
response_formatNostandard (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.