门户授权
应用 审核通过 后，在调用代购或履约 API 前，请先在开发者门户完成渠道授权。
选择分 两层：
- 履约模式 — 是否由 HioBuy 仓储并做国际发货
- 采购模式（仅开启仓库履约时）— 淘宝 / 1688 / 微店由谁下单采购
履约模式（按应用）
| 模式 | 仓库绑定 | 国际运输（/v1/fulfillment/*） |
|---|---|---|
| 自行履约（默认） | 无 — 物流自行处理 | 不可用（403） |
| HioBuy 仓库履约 | 一个仓库开发者码 | 可用 — 履约总览 |
对外 Public API 路径不变（/v1/products/*、/v1/orders/* 等），由 Gateway 按应用模式分流。
仓库履约下的采购（两种）
选择 HioBuy 仓库履约 后，采购 支持两种方式。仓配与国际发货两种都可用，区别只在于 谁在卖场下采购单。
| 采购模式 | 谁在卖场下单 | 渠道 token | /v1/orders/* | /v1/products/* |
|---|---|---|---|---|
| HioBuy 代采（默认） | 由 HioBuy 代你采购 | 仓库 authorize 下发，Gateway 存库 | 经 HioBuy 仓库采购链路 | Gateway 用存库 token → 卖场 |
| 自行采购 | 你用自己的账号采购 | 你在门户自行 OAuth / 录入 | Gateway → 卖场（你的 token，与经典自行履约采购一致） | 同上 — 你的 token |
| 能力 | HioBuy 代采 | 自行采购 |
|---|---|---|
| 一次绑定仓库码 | 是 | 是 |
| 入库 / 包裹 / VAS / 退运 | 是 | 是 |
| 国际发货单与钱包 | 是 | 是 |
| 自行管理卖场 OAuth | 否 | 是（按渠道） |
两种采购方式之间切换可能清理或重发渠道 token，门户会提示确认。
自行履约（不使用 HioBuy 仓库）
对每个已启用渠道（淘宝、1688、微店等）：
- 打开「授权」→ 选择应用 →「授权」
- 粘贴 OAuth 凭证，或在可用时完成 OAuth
- 门户显示状态、账号名、过期时间 — 从不展示完整 token
此模式下不可用 /v1/fulfillment/*。
HioBuy 仓库履约（绑定步骤）
套餐： HioBuy 仓库履约与专属支持需付费套餐（Growth / Enterprise）。免费套餐包含自助文档与 Sandbox 访问。专属对接与履约支持在付费套餐中提供。
- 向 HioBuy 运营获取 仓库开发者码
- 门户 →「授权」→ 选择 使用 HioBuy 履约
- 选择 采购模式：HioBuy 代采 或 自行采购
- 一次性输入仓库码 — 绑定在应用级（非按渠道分别绑码）
- 若为 HioBuy 代采：门户列出各渠道状态与
expires_at（token 不可见、不可编辑） - 若为 自行采购：请自行完成各渠道 OAuth / 凭证录入；仓库绑定只开通履约 API
切回 自行履约 会清除仓库绑定；系统会提示确认。
API 调用中切勿发送的内容
- 卖场 access token
- 仓库开发者码（由 Gateway 在服务端附加）
请求 https://api.hiobuy.com 时仅需 Authorization: Bearer hio_live_…（或 hio_test_…）。
获取支持
需要集成帮助？请联系开发者支持 support@hiobuy.com · 预计 1–2 个工作日内回复