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
`id`	Uno de	Igual que el `id` de search. Taobao = `mi_id`; 1688 = `offerId`
`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`

El id / mi_id de Taobao cambia periódicamente. No lo almacene en caché a largo plazo. Un id caducado falla en detail, similar y pedidos. Vuelva a consultarlo antes del checkout.

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. Al coincidir opciones, prioriza prop_id + value_id (Taobao) o prop_id (1688).

Get Support

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

Email support