海海外邮箱大全
API 接口文档

API 使用说明

先到会员中心申请完整 API Key。需要对接独角数或异次元的用户，还要同时保存 API Secret。

简易接口独角数 / 异次元标准接口

先看这里

完整 API Key会员中心申请成功后显示，只显示一次；列表里的 Key 前缀不能用于对接。
完整 API Secret独角数 / 异次元这类上游对接需要填写；如果忘记了，请在会员中心重新生成。
本站接口地址https://shop.qan8.com
下单规则只要 API 会员余额足够，创建订单后系统会自动扣余额并发货。

简易接口

适合只想简单下单拿货的客户：复制 API Key，获取商品 sku_id，然后创建订单即可。

GET 获取账户余额

https://shop.qan8.com/api/v1/open/balance?api_key=你的完整API Key

把“你的完整API Key”换成会员中心申请到的完整 Key。

GET 获取商品列表

https://shop.qan8.com/api/v1/open/products

这个接口会返回商品的 sku_id、价格、库存。下单时填写 sku_id。

POST 创建订单（下单拿货）

https://shop.qan8.com/api/v1/open/orders
Content-Type: application/json
{
  "api_key": "你的完整API Key",
  "sku_id": "商品列表返回的 sku_id",
  "quantity": 1,
  "out_order_no": "你的订单号，可不填",
  "notify_url": "你的回调地址，可不填"
}

GET 查询订单和发货内容

https://shop.qan8.com/api/v1/open/orders/订单号?api_key=你的完整API Key

订单号填写创建订单接口返回的 order_no。

独角数 / 异次元对接

如果你的系统里有“上游接口 / 供应商接口 / 独角数接口”，一般按下面这样填。

填写 后台表单怎么填

https://shop.qan8.com

不要写 /api/v1/upstream，通常只填域名。

填写会员中心显示的完整 API Key
填写会员中心显示的完整 API Secret
Dujiao-Next / 独角数 / 异次元（有哪个选哪个）

POST 测试连接

https://shop.qan8.com/api/v1/upstream/ping

GET 读取商品

https://shop.qan8.com/api/v1/upstream/products

POST 创建采购订单

https://shop.qan8.com/api/v1/upstream/orders

GET 查询采购订单

https://shop.qan8.com/api/v1/upstream/orders/{order_id}

{order_id} 使用创建采购订单返回的数字 order_id。

填写 自己写程序对接时的请求头

Dujiao-Next-Api-Key: 你的完整API Key
Dujiao-Next-Timestamp: 当前秒级时间戳
Dujiao-Next-Signature: 签名值

普通客户不需要自己算签名；独角数 / 异次元程序会自动生成签名。

标准接口

适合会写程序的客户，使用 Authorization 请求头传入完整 API Key。

GET 获取商品列表

https://shop.qan8.com/api/v1/products
Authorization: Bearer 你的完整API Key

POST 创建订单

https://shop.qan8.com/api/v1/orders
Authorization: Bearer 你的完整API Key
Content-Type: application/json
{
  "product_id": "商品ID或商品slug",
  "variant_id": "规格ID，没有规格可不填",
  "quantity": 1,
  "out_order_no": "你的订单号，可不填",
  "notify_url": "你的回调地址，可不填"
}

GET 查询订单

https://shop.qan8.com/api/v1/orders/订单号
Authorization: Bearer 你的完整API Key

返回内容怎么看

success / oktrue 表示请求成功，false 表示失败。
order_no本站订单号，查询订单时使用。
order_id独角数 / 异次元接口使用的数字订单 ID。
statuscompleted 表示已发货；processing 表示处理中；failed 表示失败。
delivery发货内容，卡密、账号或交付说明会在这里返回。
message失败原因，例如余额不足、商品不存在、库存不足。