Products API 概要
1688、Taobao、Weidian 向けの統一商品 API です。search/detail では channel を渡すか、URL parse を使って自動検出します。
価格は CNY yuan です。currency パラメータも為替換算もありません。JSON 本文で language を設定します (Languages)。response_format: "standard" (デフォルト) または "upstream" を使用できます (Response format)。
エンドポイントガイド
| トピック | エンドポイント | ドキュメント |
|---|---|---|
| 商品詳細 & SKU マトリクス | POST /v1/products/detail | Product detail |
| キーワード検索 | POST /v1/products/search | Product search |
| Similar (Taobao) | POST /v1/products/similar | Advanced endpoints |
| 再利用用の画像アップロード | POST /v1/products/upload-image | Upload image |
| 画像検索 | POST /v1/products/search-by-image | Image search |
| 商品 URL 解析 | POST /v1/products/parse | Parse URL |
| レスポンススキーマ | — | Product response models |
| 1688 カテゴリ ID | — | 1688 カテゴリ |
| チャネル、送料、分析 | various | Advanced endpoints |
チャネル機能
ライブフラグを取得: GET /v1/products/channels。概要:
| 機能 | 1688 | Taobao | Weidian |
|---|---|---|---|
| Detail | ✓ | ✓ | ✓ |
| Keyword search | ✓ | ✓ | — |
| Image search | ✓ | ✓ | — |
| URL parse | ✓ | ✓ | ✓ |
Taobao口令 (tao_password) | — | ✓ | — |
| Domestic freight estimate | ✓ | ✓ | — |
| Auto purchase (orders) | ✓ | ✓ | チャネルにより異なる |
調達マッピング {#procurement-mapping}
product detail でバリエーションを選択した後、ID を order lines にマッピングします。
| Detail field | Order field |
|---|---|
id (1688 offerId; Taobao mi_id) | lines[].id (compatible: offer_id, Taobao mi_id) |
source_product_id | 1688 same as id; Taobao = item_id |
variants[].sku_id | lines[].spec_id |
作成フロー全体は Order preview を参照してください。
Taobao の
id/mi_idは定期的に変わります。 長期キャッシュしないでください。古い id では detail / similar / 注文が失敗します。チェックアウト前に再取得してください。
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days