Product API レスポンスモデル

response_format: "standard" (デフォルト) では、商品エンドポイントは以下の型を返します。正規の TypeScript: packages/shared/src/products.ts。

エンドポイント: detail · search · image search · parse

レスポンスエンベロープ {#envelope}

StandardProductDetail {#standard-product-detail}

商品ページとチェックアウト向けの完全な商品スナップショットです。注文へのマッピング: search/detail id → lines[].id (offer_id / Taobao mi_id still accepted), variants[].sku_id → spec_id (Procurement orders)。

ID とチャネル

ローカライズ済みテキスト (title, description)

価格 (price, price_tiers[])

すべての金額は CNY yuan (fen ではありません)。promotion_amount が設定されていれば優先し、なければ display_amount を使用します。

メディア (images[], videos)

属性とバリエーション

SKU 選択と注文明細に使うのは variants[] だけです。

バリエーションオブジェクト (variants[])

SKU 梱包寸法（variants[].shipping）

1688 上流の productShippingInfo.skuShippingDetails（SkuShippingDetail）からマッピング。Taobao には相当データがなく常に null。空または 0 の寸法/重量は null に正規化。SKU に寸法データが無い場合、shipping 自体が null。

運賃見積もりでは official_* を優先し、次に出品者申告の寸法/重量、さらに ai_weight_kg（ai_weight_accuracy を信頼度の目安に）を使います。

販売者、配送、メタデータ

例 (省略)

{
  "product": {
    "id": "554456348334",
    "channel": "1688",
    "source_product_id": "554456348334",
    "title": {
      "original": "...",
      "translated": "...",
      "language": "en"
    },
    "price": {
      "display_amount": 29.9,
      "promotion_amount": 24.9
    },
    "variants": [
      {
        "sku_id": "b266e0...",
        "upstream_sku_id": "12123313",
        "stock": 100,
        "shipping": {
          "width_cm": 10,
          "length_cm": 10,
          "height_cm": 10,
          "weight_kg": 1.2,
          "official_width_cm": 5,
          "official_length_cm": 12,
          "official_height_cm": 14,
          "official_weight_kg": 0.001,
          "ai_weight_kg": 0.001,
          "ai_weight_accuracy": "80%",
          "source": "商家自填"
        }
      }
    ]
  },
  "request_id": "req_..."
}

チャネル別フィールド提供状況

StandardProductList {#standard-product-list}

search と image search から返されます。各 items[] エントリはサマリーです。SKU マトリクスは detail を呼び出してください。

StandardProductListItem

Upload-image レスポンス {#upload-image-response}

バリエーション選択 {#variant-selection}

1. detail を読み込み、product.variants を確認します。
2. ディメンションピッカー用に attributes[].original_name でグループ化します（prop_id がある場合は ID でも可）。
3. ユーザーの各選択でバリエーションを絞り込み、在庫切れの選択肢を無効化します。
4. 一致した sku_id と source_product_id を order preview に渡します。

照合キー: Taobao で prop_id + value_id がある場合は ID を優先します（安定した CPV 識別子で、多数の SKU が同じ属性名を共有する場合の取り違えを防げます）。UI のグループ化は original_name + original_value にフォールバック。name / value は表示専用。ラベルから意味タイプを推測しないでください。

{
  "prop_id": "1627207",
  "value_id": "43553464153",
  "name": "Color Classification",
  "value": "[Special for Bicycle Maintenance] Professional 46-Piece Set",
  "original_name": "颜色分类",
  "original_value": "【自行车维修专用】专业46件套",
  "image": "https://img.alicdn.com/..."
}

1688 も同じ形で、prop_id は attributeId、value_id は null（上流 SkuAttribute に valueId なし）です。