HIOBuy Open Platform

HIOBuy ist ein offiziell autorisierter Technologiepartner von Taobao, 1688 und Weidian. Wir verbinden chinesische Bezugsquellen über eine einheitliche API mit Ihrer Plattform - nicht nur für Produktdaten, sondern für den gesamten Weg von der Katalogsynchronisierung über automatisierten Einkauf bis hin zu optionaler internationaler Zustellung.

Was HIOBuy bietet

Anders als generische Marketplace-Scraper oder reine Read-only-Datenfeeds ist HIOBuy auf End-to-End-Fulfillment ausgelegt. Ihre Integration soll echte Transaktionen in Ihrem Storefront und über unsere Beschaffungs-APIs auslösen.

Diagramm (HIOBuy verbindet chinesische Quellen mit Ihrer Plattform: Produktsync, Auftragseingang, Auto‑Einkauf und Status‑Sync)

HIOBuy steht zwischen chinesischen Marktplätzen und Ihrem Unternehmen — synchronisiert Produkte, nimmt Bestellungen entgegen, kauft automatisiert ein und liefert Statusupdates zurück zu Ihrem Dashboard.

Fähigkeit	Bedeutung für Sie
Produktsynchronisierung	Suche, Details, Bildsuche, SKU/Bestand/Preis von 1688, Taobao und Weidian über /v1/products/*
Bestellannahme	Ihr Backend sendet Kundenbestellungen an HIOBuy, wenn in Ihrem Shop ein Verkauf erfolgt
Automatischer Einkauf	HIOBuy platziert die entsprechende Bestellung im Quell-Marktplatz über /v1/orders/*
Statussynchronisierung	Einkaufsfortschritt, Inlandlogistik und im Warehouse-Modus internationales Tracking fließen zurück in Ihre Systeme - siehe Webhooks
Internationales Fulfillment	Optional: eingehende Warehouse-Pakete werden über /v1/fulfillment/* ins Ausland versendet (nur Warehouse-Modus)

Wodurch wir uns von anderen APIs unterscheiden

• Offizieller Channel-Zugang - autorisierte Partnerintegrationen statt inoffiziellem Scraping.
• Transaktionsorientiert - Produkt-APIs unterstützen Sourcing und Checkout; Beschaffungs-APIs schließen den Einkaufsprozess ab.
• Einheitliche Standardantworten - ein Schema für 1688, Taobao und Weidian; siehe Antwortformat.
• Optionales Full-Stack-Fulfillment - Self-Modus für Käufer, die ihre Logistik selbst betreiben; Warehouse-Modus, wenn HIOBuy lagern und international versenden soll.

Zulässige Nutzung & Kontingente {#acceptable-use}

API-Zugriff ist nicht unbegrenzt. Kontingente und Rate Limits hängen von Ihrer kommerziellen Vereinbarung und dem erwarteten Transaktionsvolumen (GMV) über die Plattform ab.

HIOBuy ist für Integrationen vorgesehen, bei denen Produktsuche zu echten Bestellungen führt - Kunden kaufen auf Ihrer Website, und Ihr Backend ruft /v1/orders/* zur Beschaffung auf. Anwendungen, die nur Produktsuche/-details abrufen, ohne nennenswerte Einkaufsaktivität zu erzeugen, oder die HIOBuy bei der Beschaffung umgehen, während sie unsere Katalog-APIs nutzen, werden nicht unterstützt und können nach Prüfung gesperrt werden.

Technische Rate-Limit-Header und Fehlercodes sind unter Rate Limits dokumentiert. Kommerzielle Bedingungen werden beim Onboarding vereinbart und nicht auf jeder Endpoint-Seite wiederholt.

Integrationsabläufe {#integration-flows}

Wählen Sie im Developer Portal einen Fulfillment-Modus, wenn Sie Ihre App autorisieren. Der Produkt-API-Pfad ist ähnlich; Beschaffung und internationaler Versand unterscheiden sich.

Self-Fulfillment - Sie betreiben die Beschaffung

Am besten geeignet, wenn Sie bereits Marketplace-Konten besitzen und Lagerung selbst übernehmen.

1. Produktsynchronisierung - 1688 / Taobao / Weidian → HIOBuy Gateway: Suche, Details, Bilder, SKU, Bestand
2. Anzeige - HIOBuy Gateway → Ihr Storefront
3. Kundenbestellung - Ihr Kunde → Ihre Website
4. Beschaffung - Ihr Backend → HIOBuy Gateway: POST /v1/orders/preview → erstellen → bezahlen
5. Automatischer Einkauf - HIOBuy Gateway → Marketplace (Ihr OAuth)
6. Statusrückgabe - Marketplace → HIOBuy Gateway: Einkauf & Inlandlogistik
7. Dashboard-Synchronisierung - HIOBuy Gateway → Ihr Dashboard

Internationaler Versand (/v1/fulfillment/*) ist im Self-Modus nicht verfügbar. Sie übernehmen die Auslandszustellung selbst.

HIOBuy-Warehouse-Fulfillment - End-to-End

Ein Warehouse-Code bindet alle Channels; HIOBuy beschafft, lagert und versendet international.

1. Produkt-APIs - rufen Marktplätze weiterhin direkt auf (geringe Latenz)
2. Produktsynchronisierung - zu Ihrer kundenorientierten Website
3. Kundenbestellung - auf Ihrer Website
4. Beschaffung - POST /v1/orders/* (an das HIOBuy-Warehouse weitergeleitet)
5. Automatischer Einkauf - HIOBuy-Warehouse → Marketplace mit verwalteten Tokens
6. Inbound - Waren treffen ein; parcel_nos in der Bestelldetailansicht
7. International - freight/estimate → preview → create → pay
8. Zustellung - Tracking über /v1/fulfillment/shipments/logistics/trace

Beschaffungs- und internationale APIs laufen über HIOBuy. Produkt-APIs bleiben aus Geschwindigkeitsgründen direkt an die Plattformen angebunden.

Modusvergleich

	Self-Fulfillment	HIOBuy-Warehouse
Channel-Tokens	Sie verwalten OAuth pro Channel	Ein Warehouse-Code bindet alle Channels
/v1/products/*	Gateway → Marketplace	Gateway → Marketplace (direkt, geringe Latenz)
/v1/orders/*	Gateway → Marketplace (Ihre Tokens)	Gateway → HIOBuy-Warehouse-API
/v1/fulfillment/*	Nicht verfügbar	Internationaler Versand + Guthaben

Entwickler werden {#become-a-developer}

1. Registrieren Sie sich mit Unternehmen, Website und Use Case (z. B. Einkaufsagent, Cross-Border-Store).
2. Verifizieren Sie Ihre E-Mail-Adresse.
3. Melden Sie sich an und erstellen Sie im Developer Portal eine App - beschreiben Sie Ihre Integration und den erwarteten Traffic.
4. Warten Sie auf die HIOBuy-Prüfung. Wir genehmigen Apps, die zu transaktionsbasiertem Sourcing passen; Sie erhalten entsprechend Kontingente und Channel-Zugriff.
5. Nach Genehmigung: Channels autorisieren (Self-OAuth oder Warehouse-Code), dann unter API Keys einen API-Schlüssel erstellen.
6. Integrieren: Produktdetail → Kunden-Checkout → Beschaffungs-Preview/Create → Zahlung → Status-Webhooks. Im Warehouse-Modus den internationalen Versandablauf ergänzen.

Benötigen Sie einen Warehouse-Developer-Code? Kontaktieren Sie HIOBuy Operations, nachdem Ihre App für Warehouse-Fulfillment genehmigt wurde.

API-Referenzübersicht

Base URL: https://api.hiobuy.com/v1

Bereich	Präfix	Doku
Produkte	/v1/products/*	Produkte
Beschaffung	/v1/orders/*	Beschaffungsbestellungen
Fulfillment	/v1/fulfillment/*	Sendungen & Guthaben

Zwei Bestelltypen - nicht vermischen: Beschaffung (/v1/orders/*) kauft bei chinesischen Verkäufern in ein inländisches Warehouse ein; internationaler Versand (/v1/fulfillment/shipments/*) sendet eingegangene Pakete ins Ausland.

Empfohlene Lesereihenfolge {#reading-order}

1. Entwickler werden - Registrierung, App-Genehmigung, API-Schlüssel
2. Authentifizierung + Portal-Autorisierung
3. Produkte → Beschaffungsbestellungen
4. Optional: Fulfillment (Warehouse-Modus)
5. Fehler & Rate Limits für Produktionshärtung

Umfang der Public API {#public-api-scope}

Diese Dokumentation beschreibt die unterstützte Public-API-Oberfläche. Einige Pfade können in openapi.json  für interne oder veraltete Nutzung erscheinen (z. B. Legacy-/v1/shipments, Refund-Routen). Wenn ein Endpoint hier nicht aufgeführt ist, betrachten Sie ihn als nicht verfügbar.

Technische Konventionen {#technical-conventions}

• Auth: Authorization: Bearer YOUR_API_KEY - Authentifizierung
• Produkt-language im JSON-Body - Sprachen
• Preise: CNY Yuan bei Produkten, Fen bei Bestellungen und Sendungen
• response_format: "standard" (Standard) oder "upstream" - Antwortformat

OpenAPI-Spezifikation: api.hiobuy.com/openapi.json 

Veröffentlichte Dokumentation: hiobuy.com/api-docs