HioBuy REST API

将 HioBuy 的采购与物流能力集成到您的系统，支撑跨境电商业务。

基地址

https://open.hiobuy.com

客户端接口位于 /api/client/ 下，各文档页会给出完整路径。

接口路径前缀

路径前缀用途
/api/client/third-purchase/电商搜索、商品详情、以图搜、下单前费用预览
/api/client/open-purchase/开放工具（如 1688 卖家旺旺查询）
/api/client/daigou-open/代购订单提交

鉴权方式

名称必填类型说明
Authorization否headerBearer `<API_KEY>`，用于账户类接口 — 见 API 鉴权
X-Uuid是string商户 UUID（账户唯一标识）
Currency否string结算币种，如 `CNY`（人民币）、`USD`。需在商户后台配置对应汇率。

请在商户后台获取 API Key 与商户 UUID。

标准响应结构

所有 /api/client/ 接口返回统一 JSON 结构：

{
  "ret": 1,
  "msg": "success",
  "data": {}
}

顶层字段

名称类型说明
retnumber状态码，`1` 表示成功
msgstring状态说明
dataobject响应数据

错误处理

名称类型说明
retnumber非 `1` 表示失败，请结合 `msg` 判断
msgstring可读的错误说明

快速开始

电商平台采购（third-purchase）

  1. 获取 X-Uuid。
  2. 商品搜索 或 以图搜商品 → 商品详情。
  3. 订单预览 试算商品金额与国内运费。

代购下单（daigou-open）

  1. 准备 SKU 数据（通常来自商品详情）。
  2. 创建代购订单 提交至 HioBuy。

可选：通过 1688 卖家旺旺名 解析 1688 店铺显示名称。