经销商 API
连接您的网站或机器人
使用账户中的 API 密钥列出商品、查询余额、购买并查询订单。
认证
在 X-Api-Key 请求头中发送密钥。请在账户的 API 标签中创建。完整密钥只显示一次。
商品列表
GET /api/v1/products
返回可售国家、当前售价和库存。可用 tier=old 或 tier=new,以及 ISO 代码或国家 id 作为 country 过滤。
curl
curl "https://acceptororg.com/api/v1/products?tier=old&country=IT" \ -H "X-Api-Key: acc_your_key"
JavaScript
const res = await fetch("https://acceptororg.com/api/v1/products?tier=new", {
headers: { "X-Api-Key": "acc_your_key" },
});
const data = await res.json();余额
GET /api/v1/balance
返回密钥所有者的美元余额。
curl
curl https://acceptororg.com/api/v1/balance \ -H "X-Api-Key: acc_your_key"
JavaScript
const res = await fetch("https://acceptororg.com/api/v1/balance", {
headers: { "X-Api-Key": "acc_your_key" },
});
const data = await res.json();购买
POST /api/v1/buy
扣除该余额并创建订单。发送 Idempotency-Key 请求头可安全重试同一次购买。
curl
curl https://acceptororg.com/api/v1/buy \
-H "X-Api-Key: acc_your_key" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1001" \
-d '{"country":"IT","tier":"old","quantity":1}'JavaScript
const res = await fetch("https://acceptororg.com/api/v1/buy", {
method: "POST",
headers: {
"X-Api-Key": "acc_your_key",
"Content-Type": "application/json",
"Idempotency-Key": "order-1001",
},
body: JSON.stringify({ country: "IT", tier: "old", quantity: 1 }),
});
const data = await res.json();订单状态
GET /api/v1/orders/:id
返回您的一笔订单状态。若有 download_url,请用同一密钥请求该地址。这是我们的下载代理,不是供应商地址。
curl
curl https://acceptororg.com/api/v1/orders/ORDER_ID \ -H "X-Api-Key: acc_your_key"
JavaScript
const res = await fetch("https://acceptororg.com/api/v1/orders/ORDER_ID", {
headers: { "X-Api-Key": "acc_your_key" },
});
const data = await res.json();速率限制
每个密钥默认每分钟 60 次请求,除非另设限制。超出返回 429。
错误代码
unauthorized
密钥缺失、未知或已撤销。
rate_limited
这一分钟内请求过多。
invalid_request
查询或正文缺少字段,或值无效。
not_found
该订单不属于此密钥。
insufficient_balance
余额不足以支付订单。
out_of_stock
库存不足以满足数量。
price_unavailable
该国家与档位暂不出售。
price_increased
实时价格高于报价。未扣款。
unverified
无法核实实时库存。未扣款。
sourcing_failed
供应商拒绝了订单。余额已退回。
idempotency_conflict
此 Idempotency-Key 已用于不同的请求。
idempotency_in_progress
使用相同 Idempotency-Key 的请求仍在进行。
unavailable
API 数据库尚未就绪。