Plateforme ouverte HIOBuy

HIOBuy est un partenaire technologique officiellement autorisé de Taobao, 1688 et Weidian. Nous relions les sources d’approvisionnement chinoises à votre plateforme via une API unifiée — pas seulement pour les données produit, mais pour tout le parcours, de la synchronisation du catalogue à l’achat automatisé et, en option, à la livraison internationale.

Ce que fournit HIOBuy

Contrairement aux scrapers de marketplaces génériques ou aux flux de données en lecture seule, HIOBuy est conçu autour du fulfillment de bout en bout. Votre intégration doit permettre de véritables transactions sur votre boutique et via nos API d’approvisionnement.

Diagramme (HIOBuy connecte les sources chinoises à votre plateforme : synchronisation produit, réception des commandes, achat automatique et synchronisation des statuts)

HIOBuy se place entre les marketplaces chinoises et votre activité — synchronise les produits, reçoit les commandes, achète automatiquement et renvoie les statuts vers votre tableau de bord.

Capacité	Ce que cela signifie pour vous
Synchronisation produit	Recherche, détail, recherche par image, SKU/stock/prix depuis 1688, Taobao, Weidian via `/v1/products/*`
Réception des commandes	Votre backend envoie les commandes client à HIOBuy lorsqu’une vente a lieu sur votre site
Achat automatique	HIOBuy passe la commande correspondante sur la marketplace source via `/v1/orders/*`
Synchronisation des statuts	La progression d’achat, la logistique domestique et, en mode entrepôt, le suivi international reviennent vers vos systèmes — voir Webhooks
Fulfillment international	Optionnel : colis entrants en entrepôt expédiés à l’étranger via `/v1/fulfillment/*` (mode entrepôt uniquement)

Ce qui nous distingue des autres API

Accès par canal officiel — intégrations de partenaires autorisés, pas de scraping non officiel.
Orienté transaction — les API produit servent le sourcing et le checkout ; les API d’approvisionnement bouclent le cycle d’achat.
Réponses standard unifiées — un seul schéma pour 1688, Taobao et Weidian ; voir Format de réponse.
Fulfillment complet optionnel — mode autonome pour les acheteurs qui gèrent leur propre logistique ; mode entrepôt lorsque HIOBuy doit stocker et expédier à l’international.

Utilisation acceptable et quotas {#acceptable-use}

L’accès API n’est pas illimité. Les quotas et limites de débit sont liés à votre accord commercial et au volume de transactions (GMV) attendu via la plateforme.

HIOBuy est destiné aux intégrations où la découverte produit mène à de véritables commandes — les clients achètent sur votre site et votre backend appelle /v1/orders/* pour approvisionner. Les applications qui consomment uniquement la recherche/le détail produit sans activité d’achat significative, ou qui contournent HIOBuy pour l’approvisionnement tout en utilisant nos API catalogue, ne sont pas prises en charge et peuvent être suspendues après examen.

Les en-têtes techniques de limite de débit et les codes d’erreur sont documentés dans Limites de débit. Les conditions commerciales sont convenues lors de l’onboarding — elles ne sont pas répétées sur chaque page d’endpoint.

Flux d’intégration {#integration-flows}

Choisissez un mode de fulfillment dans le portail développeur lorsque vous autorisez votre application. Le parcours de l’API produit est similaire ; l’approvisionnement et l’expédition internationale diffèrent.

Fulfillment autonome — vous gérez l’approvisionnement

Idéal si vous avez déjà des comptes marketplace et gérez vous-même l’entreposage.

Synchronisation produit — 1688 / Taobao / Weidian → Passerelle HIOBuy : recherche, détail, images, SKU, stock
Affichage — Passerelle HIOBuy → Votre boutique
Commande client — Votre client → Votre site web
Approvisionnement — Votre backend → Passerelle HIOBuy : POST /v1/orders/preview → créer → payer
Achat automatique — Passerelle HIOBuy → Marketplace (votre OAuth)
Retour de statut — Marketplace → Passerelle HIOBuy : achat et logistique domestique
Synchronisation tableau de bord — Passerelle HIOBuy → Votre tableau de bord

L’expédition internationale (/v1/fulfillment/*) n’est pas disponible en mode autonome. Vous gérez vous-même la livraison à l’étranger.

Fulfillment entrepôt HIOBuy — de bout en bout

Un seul code entrepôt lie tous les canaux ; HIOBuy achète, stocke et expédie à l’international.

API produit — appellent toujours directement les marketplaces (faible latence)
Synchronisation produit — vers votre site destiné aux clients
Commande client — sur votre site web
Approvisionnement — POST /v1/orders/* (transmis à l’entrepôt HIOBuy)
Achat automatique — Entrepôt HIOBuy → Marketplace avec jetons gérés
Entrée entrepôt — les marchandises arrivent ; parcel_nos dans le détail de commande
International — fret/estimation → prévisualiser → créer → payer
Livraison — suivi via /v1/fulfillment/shipments/logistics/trace

Les API d’approvisionnement et internationales passent par HIOBuy. Les API produit restent directes vers les plateformes pour la vitesse.

Comparaison des modes

	Fulfillment autonome	Entrepôt HIOBuy
Jetons de canal	Vous gérez OAuth par canal	Un seul code entrepôt lie tous les canaux
`/v1/products/*`	Passerelle → marketplace	Passerelle → marketplace (direct, faible latence)
`/v1/orders/*`	Passerelle → marketplace (vos jetons)	Passerelle → API entrepôt HIOBuy
`/v1/fulfillment/*`	Non disponible	Expédition internationale + solde

Devenir développeur {#become-a-developer}

Inscrivez-vous avec votre entreprise, votre site web et votre cas d’usage (par ex. agent d’achat, boutique transfrontalière).
Vérifiez votre adresse e-mail.
Connectez-vous et créez une App dans le portail développeur — décrivez votre intégration et le trafic attendu.
Attendez la revue HIOBuy. Nous approuvons les apps alignées sur le sourcing transactionnel ; vous recevrez les quotas et accès aux canaux en conséquence.
Après approbation : autorisez les canaux (OAuth autonome ou code entrepôt), puis créez une clé API dans API Keys.
Intégrez : détail produit → checkout client → prévisualisation/création d’approvisionnement → paiement → webhooks de statut. En mode entrepôt, ajoutez le flux d’expédition internationale.

Besoin d’un code développeur entrepôt ? Contactez les opérations HIOBuy après l’approbation de votre app pour le fulfillment entrepôt.

Carte de référence API

URL de base : https://api.hiobuy.com/v1

Domaine	Préfixe	Docs
Produits	`/v1/products/*`	Produits
Approvisionnement	`/v1/orders/*`	Commandes d’approvisionnement
Fulfillment	`/v1/fulfillment/*`	Expéditions et solde

Deux types de commandes — ne les mélangez pas : l’approvisionnement (/v1/orders/*) achète auprès de vendeurs chinois vers un entrepôt domestique ; l’expédition internationale (/v1/fulfillment/shipments/*) envoie les colis entrants à l’étranger.

Ordre de lecture recommandé {#reading-order}

Devenir développeur — inscription, approbation d’app, clé API
Authentification + Autorisation portail
Produits → Commandes d’approvisionnement
Optionnel : Fulfillment (mode entrepôt)
Erreurs et Limites de débit lors du durcissement en production

Périmètre de l’API publique {#public-api-scope}

Cette documentation décrit la surface prise en charge de l’API publique. Certains chemins peuvent apparaître dans openapi.json pour un usage interne ou obsolète (par ex. anciens /v1/shipments, routes de remboursement) — si un endpoint n’est pas listé ici, considérez-le comme indisponible.

Conventions techniques {#technical-conventions}

Auth : Authorization: Bearer YOUR_API_KEY — Authentification
language produit dans le corps JSON — Langues
Prix : yuan CNY sur les produits, fen sur les commandes et expéditions
response_format: "standard" (par défaut) ou "upstream" — Format de réponse

Spécification OpenAPI : api.hiobuy.com/openapi.json

Documentation publiée : hiobuy.com/api-docs