Vue d’ensemble de l’API Produits
API produit unifiée pour 1688, Taobao et Weidian. Passez channel sur recherche/détail, ou utilisez Analyse d’URL pour la détection automatique.
Les prix sont en yuan CNY — pas de paramètre currency, pas de conversion FX. Définissez language dans le corps JSON (Langues). Utilisez response_format: "standard" (par défaut) ou "upstream" (Format de réponse).
Guide des endpoints
| Sujet | Endpoint | Doc |
|---|---|---|
| Détail produit et matrice SKU | POST /v1/products/detail | Détail produit |
| Recherche par mot-clé | POST /v1/products/search | Recherche produit |
| Similar (Taobao) | POST /v1/products/similar | Advanced endpoints |
| Téléverser une image pour réutilisation | POST /v1/products/upload-image | Téléverser une image |
| Recherche par image | POST /v1/products/search-by-image | Recherche par image |
| Analyser une URL produit | POST /v1/products/parse | Analyser une URL |
| Schémas de réponse | — | Modèles de réponse produit |
| IDs catégories 1688 | — | Catégories 1688 |
| Canaux, fret, analytics | divers | Endpoints avancés |
Capacités par canal
Interrogez les indicateurs live : GET /v1/products/channels. Résumé :
| Capacité | 1688 | Taobao | Weidian |
|---|---|---|---|
| Détail | ✓ | ✓ | ✓ |
| Recherche par mot-clé | ✓ | ✓ | — |
| Recherche par image | ✓ | ✓ | — |
| Analyse d’URL | ✓ | ✓ | ✓ |
Taobao口令 (tao_password) | — | ✓ | — |
| Estimation du fret domestique | ✓ | ✓ | — |
| Achat automatique (commandes) | ✓ | ✓ | Variable |
Mapping d’approvisionnement {#procurement-mapping}
Après la sélection de variante sur détail produit, mappez les identifiants vers les lignes de commande :
| Champ de détail | Champ de commande |
|---|---|
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 |
Voir Prévisualisation de commande pour le flux complet de création.
L’
id/mi_idTaobao change périodiquement. Ne le mettez pas en cache longtemps. Un id périmé casse detail, similar et les commandes. Récupérez-le avant le checkout.
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days