身份验证

所有公开 API 请求均需 Bearer 令牌。渠道凭证与仓库编码在开发者门户中管理——切勿将其嵌入客户端应用。

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 前，必须完成渠道授权。

详见门户授权。若渠道未授权，调用将返回 401 CHANNEL_NOT_AUTHORIZED（错误）。

切勿发送的内容 {#what-not-to-send}

• 淘宝 / 1688 / 微店的 access token 或 refresh token
• 仓库开发者编码（Gateway 会在履约路由中自动附加）
• 门户 session JWT（公开 API 调用中勿传）

请求追踪 {#tracing}

每次响应均包含：

• x-request-id 响应头——与 JSON 正文中的 request_id 对应
• 计费路由上可选的额度响应头——见限流

联系 HIOBuy 支持时请提供 x-request-id。

常见鉴权错误 {#auth-errors}