HioBuy REST API
Integrate HioBuy procurement and logistics into your application for cross-border e-commerce.
Base URL
https://open.hiobuy.comClient APIs live under /api/client/. Each endpoint page lists the full path.
API path prefixes
| Path prefix | Purpose |
|---|---|
/api/client/third-purchase/ | Marketplace search, product details, image search, order fee preview |
/api/client/open-purchase/ | Open utilities (e.g. 1688 seller Wangwang lookup) |
/api/client/daigou-open/ | Daigou (purchasing agent) order submission |
Authentication
| Name | Required | Type | Description |
|---|---|---|---|
Authorization | No | header | Bearer `<API_KEY>` for account / profile APIs — see API Authentication |
X-Uuid | Yes | string | Merchant UUID assigned to your account |
Currency | No | string | Settlement currency code, e.g. `CNY` (RMB), `USD`. Exchange rates must be configured in the merchant backend. |
Obtain your API key and merchant UUID from the merchant console.
Standard response envelope
All /api/client/ endpoints return a JSON envelope:
{
"ret": 1,
"msg": "success",
"data": {}
}Top level
| Name | Type | Description |
|---|---|---|
ret | number | Status code. `1` indicates success |
msg | string | Status message |
data | object | Response body |
Error handling
| Name | Type | Description |
|---|---|---|
ret | number | Non-`1` values indicate failure; interpret with `msg` |
msg | string | Human-readable error message |
Quick start
Marketplace procurement (third-purchase)
- Obtain your
X-Uuid. - Product Search or Image Search → Product Details.
- Order Preview to estimate fees before marketplace checkout.
Daigou order (daigou-open)
- Prepare SKU data from Product Details.
- Create Daigou Order to submit the order to HioBuy.
Optional: 1688 Seller Wangwang Name to resolve 1688 shop display names.