门户授权
应用 审核通过 后,在调用代购或履约 API 前,请先在开发者门户完成渠道授权。
履约模式(按应用)
| Mode | Who holds tokens | Procurement API | International shipping |
|---|---|---|---|
| 自履约(默认) | 你方(各渠道 OAuth / 手动 JSON) | Gateway → 卖场 | 不可用 |
| HIOBuy 仓库 | HIOBuy(单一仓库开发者码) | Gateway → HIOBuy 仓库 API | /v1/fulfillment/* |
自履约
对每个已启用渠道(淘宝、1688 等):
- 打开「授权」→ 选择应用 →「授权」
- 粘贴 OAuth 凭证,或在可用时完成 OAuth 流程
- 门户显示状态、账号名、过期时间 — 从不展示完整 token
HIOBuy 仓库履约
- 向 HIOBuy 运营获取 仓库开发者码
- 门户 →「授权」→ 选择 使用 HIOBuy 履约
- 一次性输入开发者码 — 淘宝、1688、微店一步绑定
- 门户列出各渠道状态与
expires_at(token 不可见、不可编辑)
切回自履约会清除仓库绑定;系统会提示确认。
API 调用中切勿发送的内容
- 卖场 access token
- 仓库开发者码(由 Gateway 在服务端附加)
请求 https://api.hiobuy.com 时仅需 Authorization: Bearer hio_live_…。
下一步:履约与运单 API