API de detalle de producto
POST /v1/products/detail: obtiene el detalle completo de producto para integración de checkout (matriz SKU, precios, stock).
Relacionado: Modelos de respuesta de producto · Mapeo de compras
Cuerpo de la solicitud
| Campo | Obligatorio | Descripción |
|---|---|---|
channel | Sí | 1688 | taobao | weidian |
product_id | Uno de | 1688 offerId; en Taobao prefiere mi_id frente al item_id heredado |
url | Uno de | URL de la página de producto |
mi_id | Taobao | Id de producto TaoWorld (recomendado para pedidos) |
tao_password | Taobao | Taobao share口令: pega el texto compartido completo o la cadena口令 |
language | No | Predeterminado en |
response_format | No | standard (predeterminado) o upstream |
Ejemplos
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"
}Respuesta
StandardProductDetail envuelto como { "product": { ... }, "request_id": "req_..." }; consulta Modelos de respuesta de producto.
Selección de variantes
Construye la UI de checkout desde product.variants[]; consulta el patrón de integración.