商品詳細 API

POST /v1/products/detail — チェックアウト連携に必要な完全な商品詳細 (SKU マトリクス、価格、在庫) を取得します。

関連: Product response models · Procurement mapping

リクエスト本文

フィールド必須説明
channelはい1688 | taobao | weidian
product_idいずれか1つ1688 offerId。Taobao では従来の item_id より mi_id を推奨
idいずれか1つ検索の id と同じ。Taobao = mi_id；1688 = offerId
urlいずれか1つ商品ページ URL
mi_idTaobaoTaoWorld 商品 ID (注文 API で推奨)
tao_passwordTaobaoTaobao share口令 — 共有テキスト全体または口令文字列を貼り付けます
languageいいえデフォルト en
response_formatいいえstandard (デフォルト) または upstream

Taobao の id / mi_id は定期的に変わります。 長期キャッシュしないでください。古い id では detail / similar / 注文が失敗します。チェックアウト前に再取得してください。

例

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

レスポンス

{ "product": { ... }, "request_id": "req_..." } としてラップされた StandardProductDetail — Product response models を参照してください。

バリエーション選択

product.variants[] からチェックアウト UI を構築します。integration pattern を参照してください。オプション照合では Taobao の prop_id + value_id、または 1688 の prop_id を優先してください。

Get Support

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

Email support