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 |
url | Одно из | URL страницы товара |
mi_id | Taobao | TaoWorld product id (рекомендуется для orders) |
tao_password | Taobao | Taobao share口令 — вставьте полный share text или строку 口令 |
language | Нет | По умолчанию en |
response_format | Нет | standard (по умолчанию) или upstream |
Примеры
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[] — см. паттерн интеграции.