商品詳細 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 を推奨 |
url | いずれか1つ | 商品ページ URL |
mi_id | Taobao | TaoWorld 商品 ID (注文 API で推奨) |
tao_password | Taobao | Taobao share口令 — 共有テキスト全体または口令文字列を貼り付けます |
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"
}レスポンス
{ "product": { ... }, "request_id": "req_..." } としてラップされた StandardProductDetail — Product response models を参照してください。
バリエーション選択
product.variants[] からチェックアウト UI を構築します。integration pattern を参照してください。