認証

すべての Public API リクエストには Bearer トークンが必要です。チャネル認証情報と倉庫コードは developer portal で管理します。クライアントアプリに埋め込まないでください。

API キー {#api-keys}

アプリが承認された後、Developer Portal → API Keys でキーを作成します。

リクエスト例

curl https://api.hiobuy.com/v1/products/detail \
  -H "Authorization: Bearer hio_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "1688",
    "product_id": "554456348334",
    "language": "en"
  }'

チャネル認可 (前提条件) {#channel-authorization}

API キーだけでは不十分です。各アプリは、そのマーケットプレイスの商品 API または注文 API を呼び出す前に チャネル認可 を完了する必要があります。

ポータル認可 を参照してください。チャネルが認可されていない場合、呼び出しは 401 CHANNEL_NOT_AUTHORIZED (Errors) を返します。

送信してはいけないもの {#what-not-to-send}

• Taobao / 1688 / Weidian のアクセストークンまたはリフレッシュトークン
• 倉庫開発者コード (Gateway がフルフィルメントルートに付与します)
• Public API 呼び出しでのポータルセッション JWT

リクエスト追跡 {#tracing}

すべてのレスポンスには以下が含まれます。

• x-request-id ヘッダー — JSON 本文の request_id と照合できます
• 課金対象ルートでは任意のクォータヘッダー — Rate limits を参照

HIOBuy サポートに問い合わせる際は x-request-id を含めてください。

一般的な認証エラー {#auth-errors}