ポータル認可

アプリが 承認 されたら、調達 API またはフルフィルメント API を呼び出す前に developer portal でチャネルを認可します。

選択には 2つのレイヤー があります。

  1. フルフィルメントモード — HioBuy が倉庫保管し国際配送するかどうか
  2. 調達モード（倉庫フルフィルメントがオンの場合のみ） — Taobao / 1688 / Weidian で誰が購入するか

フルフィルメントモード (アプリ単位)

モード倉庫バインディングの保持者国際配送 (/v1/fulfillment/*)
自社フルフィルメント (デフォルト)なし — 物流は自分で対応利用不可 (403)
HioBuy 倉庫倉庫開発者コード1つ利用可 — Fulfillment overview

公開 API パスは同じです (/v1/products/*、/v1/orders/*、…)。Gateway はアプリのモードに応じてルーティングします。

倉庫フルフィルメント下の調達

HioBuy 倉庫 を選ぶと、調達には 2つのオプション があります。国際倉庫保管と配送はどちらでも動作します。異なるのは マーケットプレイスでの発注者 だけです。

調達モードマーケットプレイスでの購入者チャネルトークン/v1/orders/*/v1/products/*
HioBuy 調達 (デフォルト)HioBuy が代理購入倉庫認可で発行。Gateway が保存HioBuy 倉庫調達経由でルーティングGateway が保存済みトークン → マーケットプレイス
自社調達自分のアカウントで購入ポータルで OAuth / 認証情報を管理Gateway → マーケットプレイス（自分のトークン、従来の自社フローと同じ）同様 — 自分のトークン
機能HioBuy 調達自社調達
倉庫コードを一度バインドはいはい
倉庫入庫 / packages / VAS / returnsはいはい
国際出荷 & walletはいはい
マーケットプレイス OAuth を自分で管理いいえはい (チャネルごと)

これら2つの調達オプションを切り替えると、チャネルトークンがクリアまたは再発行される場合があります。ポータルで確認を求められます。

自社フルフィルメント (HioBuy 倉庫なし)

有効化する各チャネル (Taobao, 1688, Weidian, …) について:

  1. Authorizations を開く → アプリを選択 → Authorize
  2. OAuth 認証情報を貼り付ける、または利用可能な場合は OAuth を完了する
  3. ポータルにはステータス、アカウント名、有効期限が表示されます。完全なトークンは表示されません

このモードでは /v1/fulfillment/* は利用できません。

HioBuy 倉庫フルフィルメント (セットアップ)

プラン： HioBuy 倉庫フルフィルメントと専任サポートは有料プラン（Growth / Enterprise）が必要です。無料プランにはセルフサービスのドキュメントと Sandbox アクセスが含まれます。専任のインテグレーションおよびフルフィルメントサポートは有料プランで利用できます。

  1. HioBuy 運用担当から 倉庫開発者コード を取得します
  2. Portal → Authorizations → Use HioBuy fulfillment を選択
  3. 調達モード を選択: HioBuy 調達 または 自社調達
  4. 倉庫コードを一度入力 — バインディングはアプリ単位（チャネル単位ではない）
  5. HioBuy 調達 の場合: ポータルに各チャネルのステータスと expires_at が表示されます（トークンは表示・編集不可）
  6. 自社調達 の場合: 通常どおりチャネルごとの OAuth / 認証情報入力を自分で完了。倉庫バインディングはフルフィルメント API のアンロックのみ

自社フルフィルメント に戻すと倉庫バインディングはクリアされ、確認を求められます。

API 呼び出しで送信してはいけないもの

  • マーケットプレイスのアクセストークン
  • 倉庫開発者コード (Gateway がサーバー側で付与します)

https://api.hiobuy.com では Authorization: Bearer hio_live_…（または hio_test_…）のみを送信します。

次へ: Fulfillment overview · Orders

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support