Portal-Autorisierung
Nachdem Ihre App genehmigt wurde, autorisieren Sie Channels im Developer Portal, bevor Sie Beschaffungs- oder Fulfillment-APIs aufrufen.
Es gibt zwei Entscheidungsebenen:
- Fulfillment-Modus — ob HioBuy einlagert und international versendet
- Beschaffungsmodus (nur wenn Warehouse-Fulfillment aktiv ist) — wer auf Taobao / 1688 / Weidian kauft
Fulfillment-Modus (pro App)
| Modus | Wer hält die Warehouse-Bindung | Internationaler Versand (/v1/fulfillment/*) |
|---|---|---|
| Self-Fulfillment (Standard) | Keine — Sie übernehmen die Logistik selbst | Nicht verfügbar (403) |
| HioBuy-Warehouse | Ein Warehouse-Developer-Code | Verfügbar — Fulfillment overview |
Öffentliche API-Pfade bleiben gleich (/v1/products/*, /v1/orders/*, …). Das Gateway routet anhand der Modi Ihrer App.
Beschaffung unter Warehouse-Fulfillment
Wenn Sie HioBuy-Warehouse wählen, unterstützt die Beschaffung zwei Optionen. Internationale Einlagerung und Versand funktionieren in beiden; unterschiedlich ist nur, wer Marketplace-Kaufaufträge platziert.
| Beschaffungsmodus | Wer auf dem Marketplace kauft | Channel-Tokens | /v1/orders/* | /v1/products/* |
|---|---|---|---|---|
| HioBuy-Beschaffung (Standard) | HioBuy kauft für Sie | Werden über Warehouse-Authorize ausgestellt; Gateway speichert sie | Routing über HioBuy-Warehouse-Beschaffung | Gateway nutzt gespeicherte Tokens → Marketplace |
| Self-Beschaffung | Sie kaufen mit eigenen Konten | Sie verwalten OAuth / Zugangsdaten im Portal | Gateway → Marketplace mit Ihren Tokens (wie beim klassischen Self-Flow) | Gleich — Ihre Tokens |
| Fähigkeit | HioBuy-Beschaffung | Self-Beschaffung |
|---|---|---|
| Warehouse-Code einmal binden | Ja | Ja |
| Warehouse inbound / packages / VAS / returns | Ja | Ja |
| International shipments & wallet | Ja | Ja |
| Marketplace-OAuth selbst verwalten | Nein | Ja (pro Channel) |
Ein Wechsel zwischen diesen beiden Beschaffungsoptionen kann Channel-Tokens löschen oder neu ausstellen; das Portal fordert Sie zur Bestätigung auf.
Self-Fulfillment (kein HioBuy-Warehouse)
Für jeden aktivierten Channel (Taobao, 1688, Weidian, …):
- Authorizations öffnen → App auswählen → Authorize
- OAuth-Zugangsdaten einfügen oder OAuth abschließen, wenn verfügbar
- Portal zeigt Status, Kontoname, Ablaufdatum — niemals vollständige Tokens
/v1/fulfillment/* ist in diesem Modus nicht verfügbar.
HioBuy-Warehouse-Fulfillment (Setup)
- Einen Warehouse-Developer-Code von HioBuy Ops erhalten
- Portal → Authorizations → Use HioBuy fulfillment wählen
- Beschaffungsmodus wählen: HioBuy-Beschaffung oder Self-Beschaffung
- Warehouse-Code einmal eingeben — Bindung ist app-weit (nicht pro Channel)
- Bei HioBuy-Beschaffung: Portal listet Status und
expires_atjedes Channels (Tokens sind weder sichtbar noch editierbar) - Bei Self-Beschaffung: normale OAuth- / Credential-Eingabe pro Channel selbst abschließen; die Warehouse-Bindung schaltet nur Fulfillment-APIs frei
Ein Wechsel zurück zu Self-Fulfillment löscht die Warehouse-Bindung; Sie werden zur Bestätigung aufgefordert.
Was Sie niemals in API-Aufrufen senden
- Marketplace-Access-Tokens
- Warehouse-Developer-Code (Gateway fügt ihn serverseitig an)
Nur Authorization: Bearer hio_live_… (oder hio_test_…) auf https://api.hiobuy.com.
Weiter: Fulfillment overview · Orders
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days