API деталей товара

POST /v1/products/detail — получает полные детали товара для checkout integration (SKU matrix, цены, остатки).

Связано: модели ответов товаров · маппинг закупки

Request body

Поле	Обязательно	Описание
`channel`	Да	`1688` \| `taobao` \| `weidian`
`product_id`	Одно из	1688 `offerId`; для Taobao предпочтительнее `mi_id`, а не legacy `item_id`
`id`	Одно из	Тот же `id`, что в search. Taobao = `mi_id`; 1688 = `offerId`
`url`	Одно из	URL страницы товара
`mi_id`	Taobao	TaoWorld product id (рекомендуется для orders)
`tao_password`	Taobao	Taobao share口令 — вставьте полный share text или строку 口令
`language`	Нет	По умолчанию `en`
`response_format`	Нет	`standard` (по умолчанию) или `upstream`

Taobao id / mi_id периодически меняется. Не кэшируйте надолго. Устаревшие id ломают detail, similar и заказы. Повторите поиск/detail перед checkout.

Примеры

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"
}

Ответ

StandardProductDetail обернут как { "product": { ... }, "request_id": "req_..." } — см. модели ответов товаров.

Выбор variant

Стройте checkout UI на основе product.variants[] — см. паттерн интеграции. При сопоставлении опций предпочитайте prop_id + value_id (Taobao) или prop_id (1688).

Get Support

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

Email support