API chi tiết sản phẩm

POST /v1/products/detail — lấy chi tiết sản phẩm đầy đủ cho tích hợp checkout (ma trận SKU, giá, tồn kho).

Liên quan: Product response models · Procurement mapping

Request body

FieldRequiredDescription
channelYes1688 | taobao | weidian
product_idOne of1688 offerId; Taobao ưu tiên mi_id hơn legacy item_id
urlOne ofURL trang sản phẩm
mi_idTaobaoTaoWorld product id (khuyến nghị cho orders)
tao_passwordTaobaoTaobao share口令 — dán toàn bộ share text hoặc chuỗi口令
languageNoMặc định en
response_formatNostandard (mặc định) hoặc upstream

Ví dụ

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 được bọc dưới dạng { "product": { ... }, "request_id": "req_..." } — xem Product response models.

Chọn variant

Xây dựng UI checkout từ product.variants[] — xem integration pattern.