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_idTaobaoTaoWorld product id (рекомендуется для orders)
tao_passwordTaobaoTaobao 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[] — см. паттерн интеграции.