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

Field	Required	Description
`channel`	Yes	`1688` \| `taobao` \| `weidian`
`product_id`	One of	1688 `offerId`; Taobao ưu tiên `mi_id` hơn legacy `item_id`
`id`	One of	Giống `id` từ search. Taobao = `mi_id`; 1688 = `offerId`
`url`	One of	URL trang sản phẩm
`mi_id`	Taobao	TaoWorld product id (khuyến nghị cho orders)
`tao_password`	Taobao	Taobao share口令 — dán toàn bộ share text hoặc chuỗi口令
`language`	No	Mặc định `en`
`response_format`	No	`standard` (mặc định) hoặc `upstream`

id / mi_id Taobao thay đổi định kỳ. Đừng cache lâu. Id cũ sẽ làm detail, similar và đơn hàng thất bại. Lấy lại trước khi checkout.

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. Khi khớp tùy chọn, ưu tiên prop_id + value_id (Taobao) hoặc prop_id (1688).

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support