Product API レスポンスモデル

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

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

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

StandardProductDetail {#standard-product-detail}

商品ページとチェックアウト向けの完全な商品スナップショットです。注文へのマッピング: source_product_id → offer_id, 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[])

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

例 (省略)

{
  "product": {
    "id": "1688_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...",
        "stock": 100
      }
    ]
  },
  "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 でグループ化します。
3. ユーザーの各選択でバリエーションを絞り込み、在庫切れの選択肢を無効化します。
4. 一致した sku_id と source_product_id を order preview に渡します。