Acceptor_org
登录

经销商 API

连接您的网站或机器人

使用账户中的 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 数据库尚未就绪。