HIOBuy Open Platform

HIOBuy は Taobao、1688、Weidian の 公式認定テクノロジーパートナー です。中国の供給元を統一 API であなたのプラットフォームへ接続します。提供するのは商品データだけではなく、カタログ同期から自動購入、そして任意の国際配送までの一連の流れです。

HIOBuy が提供するもの

一般的なマーケットプレイススクレイパーや読み取り専用データフィードとは異なり、HIOBuy は エンドツーエンドのフルフィルメント を中心に設計されています。連携は、あなたのストアフロント上の実取引と、当社の調達 API を通じた購入処理を動かすものであるべきです。

図 (HIOBuy は商品同期、注文受信、自動購入、ステータス同期により中国の供給元をあなたのプラットフォームへ接続します)

HIOBuy は中国マーケットプレイスとあなたのビジネスの間に入り、商品を同期し、注文を受け取り、自動購入を行い、ステータスをあなたのダッシュボードへ戻します。

機能	あなたにとっての意味
Product sync	`/v1/products/*` を通じて、1688、Taobao、Weidian から検索、詳細、画像検索、SKU/在庫/価格を取得
Order receiving	あなたのサイトで販売が発生したとき、バックエンドが顧客注文を HIOBuy に送信
Auto purchasing	HIOBuy が `/v1/orders/*` を通じて、供給元マーケットプレイスに対応する注文を作成
Status sync	購入進捗、国内物流、(倉庫モードでは) 国際追跡があなたのシステムへ戻ります。Webhooks を参照
International fulfillment	任意: `/v1/fulfillment/*` を通じて入庫済み倉庫荷物を海外へ配送 (倉庫モードのみ)

他の API との違い

公式チャネルアクセス — 非公式スクレイピングではなく、認定パートナー連携です。
取引志向 — 商品 API は仕入れとチェックアウトを支えるためにあり、調達 API が購入ループを完了します。
統一された標準レスポンス — 1688、Taobao、Weidian をまたいで1つのスキーマを使用します。Response format を参照してください。
任意のフルスタックフルフィルメント — 自社で物流を管理する購入者向けの self mode と、HIOBuy が保管と国際配送を行う warehouse mode。

許容される利用とクォータ {#acceptable-use}

API アクセスは 無制限ではありません。クォータとレート制限は、商業契約およびプラットフォーム経由で想定される 取引量 (GMV) に紐づきます。

HIOBuy は、商品発見が 実際の注文 につながる連携を対象としています。顧客があなたのサイトで購入し、バックエンドが /v1/orders/* を呼び出して調達します。商品検索/詳細だけを消費し、有意な購入活動がないアプリケーション、または当社カタログ API を利用しながら調達では HIOBuy を迂回するアプリケーションは サポート対象外 であり、審査後に停止される場合があります。

技術的なレート制限ヘッダーとエラーコードは Rate limits に記載されています。商業条件はオンボーディング時に合意されるもので、個別のエンドポイントページには繰り返し記載していません。

連携フロー {#integration-flows}

アプリを認可するときに developer portal でフルフィルメントモードを選択します。商品 API の経路は似ていますが、調達と国際配送が異なります。

自社フルフィルメント — 自社で調達を運用

すでにマーケットプレイスアカウントを持ち、自社で倉庫運用を行っている場合に適しています。

Product sync — 1688 / Taobao / Weidian → HIOBuy Gateway: 検索、詳細、画像、SKU、在庫
Display — HIOBuy Gateway → あなたのストアフロント
Customer order — あなたの顧客 → あなたのウェブサイト
Procurement — あなたのバックエンド → HIOBuy Gateway: POST /v1/orders/preview → create → pay
Auto-purchase — HIOBuy Gateway → マーケットプレイス (あなたの OAuth)
Status return — マーケットプレイス → HIOBuy Gateway: 購入と国内物流
Dashboard sync — HIOBuy Gateway → あなたのダッシュボード

国際配送 (/v1/fulfillment/*) は self mode では 利用できません。海外配送は自社で処理します。

HIOBuy 倉庫フルフィルメント — エンドツーエンド

1つの倉庫コードがすべてのチャネルを紐づけます。HIOBuy が調達、保管、国際配送を行います。

Product APIs — これまで通りマーケットプレイスを直接呼び出します (低レイテンシ)
Product sync — 顧客向けサイトへ
Customer order — あなたのウェブサイト上で
Procurement — POST /v1/orders/* (HIOBuy 倉庫へ転送)
Auto-purchase — HIOBuy 倉庫 → 管理トークンでマーケットプレイスへ
Inbound — 商品が到着し、注文詳細に parcel_nos が入ります
International — freight/estimate → preview → create → pay
Delivery — /v1/fulfillment/shipments/logistics/trace で追跡

調達 API と国際 API は HIOBuy 経由でルーティングされます。商品 API は速度のために各プラットフォームへ直接アクセスします。

モード比較

	自社フルフィルメント	HIOBuy 倉庫
チャネルトークン	チャネルごとの OAuth を自社で管理	1つの倉庫コードが全チャネルを紐づけ
`/v1/products/*`	Gateway → マーケットプレイス	Gateway → マーケットプレイス (直接、低レイテンシ)
`/v1/orders/*`	Gateway → マーケットプレイス (あなたのトークン)	Gateway → HIOBuy warehouse API
`/v1/fulfillment/*`	利用不可	国際配送 + 残高

開発者になる方法 {#become-a-developer}

会社、ウェブサイト、ユースケース (例: 購入代行、越境ストア) を登録します。
メールアドレスを確認します。
サインインし、developer portal で App を作成します。連携内容と想定トラフィックを説明してください。
HIOBuy review を待ちます。取引ベースの仕入れに合致するアプリを承認し、それに応じてクォータとチャネルアクセスを付与します。
承認後: authorize channels (self OAuth または warehouse code) を行い、API Keys で API キーを作成します。
連携: 商品詳細 → 顧客チェックアウト → 調達 preview/create → pay → ステータス webhooks。倉庫モードでは国際配送フローを追加します。

倉庫開発者コードが必要ですか? アプリが倉庫フルフィルメント向けに承認された後、HIOBuy 運用担当に連絡してください。

API リファレンスマップ

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

領域	Prefix	Docs
Products	`/v1/products/*`	Products
Procurement	`/v1/orders/*`	Procurement orders
Fulfillment	`/v1/fulfillment/*`	Shipments & balance

2種類の注文を混同しないでください: 調達 (/v1/orders/*) は中国の販売者から国内倉庫へ購入します。国際配送 (/v1/fulfillment/shipments/*) は入庫済み荷物を海外へ発送します。

推奨される読み進め方 {#reading-order}

Become a developer — 登録、アプリ承認、API キー
Authentication + Portal authorization
Products → Procurement orders
任意: Fulfillment (倉庫モード)
本番運用を堅牢化するときは Errors & Rate limits

Public API の範囲 {#public-api-scope}

このドキュメントは サポート対象の Public API surface を説明します。一部のパスは内部用または非推奨用途 (例: 旧 /v1/shipments、返金ルート) として openapi.json に表示される場合があります。ここに掲載されていないエンドポイントは利用不可として扱ってください。

技術的な規約 {#technical-conventions}

Auth: Authorization: Bearer YOUR_API_KEY — Authentication
JSON 本文内の商品 language — Languages
価格: 商品は CNY yuan、注文と配送は fen
response_format: "standard" (デフォルト) または "upstream" — Response format

OpenAPI spec: api.hiobuy.com/openapi.json

Published documentation: hiobuy.com/api-docs