以编程方式访问目录并使用钱包余额购买。用带权限范围的 API 密钥认证、用余额购买并查询订单状态 — 与店面使用同一引擎。
经销商 API 当前在此实例上已停用。启用前接口返回 404。
在您的账户中创建带权限范围的密钥,并将其作为 Bearer 令牌发送(也接受 X-API-Key 请求头)。明文密钥仅在创建时显示一次 — 请妥善保管;我方只保留哈希。
curl -H "Authorization: Bearer ask_xxxxxxxx_..." \
https://nexusmarket.one/api/v1/balance每个密钥仅限于您授予它的权限范围。若密钥缺少接口所需权限,接口返回 403。
每个密钥有自己的令牌桶限制(默认每分钟 100 次请求)。超出时响应为 429,并带 Retry-After 请求头指示需等待的秒数。
在购买时发送可选的 Idempotency-Key 请求头,以防重试导致钱包被重复扣款:相同密钥和请求体的重复请求会重放原始响应;相同密钥但请求体不同则返回 409。
curl -X POST https://nexusmarket.one/api/v1/purchase \
-H "Authorization: Bearer ask_xxxxxxxx_..." \
-H "Idempotency-Key: order-2026-06-11-0001" \
-H "Content-Type: application/json" \
-d '{"productId":"clxyz...","quantity":2}'/products带实时库存和统一价格的分页目录。
/products/{slug}按 slug 查询单个商品详情,含实时库存。
/categories已本地化的活动分类树。
/purchase用您的钱包余额购买;已交付商品在响应中返回。
/order-status您某个订单的状态和行项摘要。
/balance您权威的钱包余额(以美分计)。
每个错误都使用统一的封装,含稳定的机器可读代码、人类可读消息和可选的逐字段校验详情。
{
"ok": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Wallet balance is insufficient for this purchase"
}
}