沙盒

独立的一套环境,使用测试 USDT。接口契约与正式环境 API 相同:一个环境的密钥不能在另一个环境中使用(401)。

更新于 2026年10月8日 · 阅读约需 5 分钟
Markdown

沙盒密钥

地址与密钥

API 地址https://sandbox-api.astrum.shop/v1
密钥ask_test_…在此使用正式环境密钥会返回 401
Webhook 签名密钥whsec_test_…
事件sandbox: true用于与正式环境事件区分

沙盒限额

访客密钥无需申请即可领取,因此单独设有比正式环境更严格的限额。限额同时按密钥和 IP 地址计算:同一地址的多个密钥共享同一个限额。

API 密钥
3/天
每个 IP 地址
300/天
所有访客合计,按莫斯科时间计日
14天
无请求后密钥失效
请求
30/分钟
每个密钥
60/分钟
每个 IP 地址,所有密钥合计
60/分钟
正式密钥
订单
5/分钟
订单数
100/天
每个密钥的订单数
60 和 200
正式密钥每分钟与每天订单数
测试余额
1 000USDT
单次
5 000USDT
每个密钥每天
任意
充值地址中的网络
Webhook
1
每个密钥的 Webhook 地址数
https
仅限公网地址
60/小时
投递次数,含重试和测试
数据
独立数据库
沙盒专用,非正式环境
互不影响
正式 API 及其限额
14天
无活动后访客数据即被删除

超出限额时返回 429,Retry-After 给出多少秒后可以重试。错误码与正式环境相同:20001 too_many_requests、20002 too_many_orders、20004 daily_order_limit_reached。

HTTP/1.1 429 Too Many Requests
Retry-After: 18720

{
  "error": {
    "code": 80003,
    "name": "sandbox_address_limit",
    "message": "该地址 24 小时内领取的沙盒密钥已达上限",
    "details": {
      "retry_after": 18720,
      "per_address_per_day": 3
    },
    "request_id": "req_4f0c2a9e1b7d3c58"
  }
}

需要更高限额,请使用正式环境密钥

正式环境密钥有自己的限额,可通过 GET /v1/account 查看。正式环境密钥需要申请,通过一次性链接签发:请在 https://astrum.shop/docs 的「正式密钥需申请」表单中提交申请。

沙盒的工作方式

密钥

访客密钥:通过上方按钮、命令 curl -fsSL https://astrum.shop/connect | sh,或不带密钥调用 POST /v1/sandbox/keys 领取。合作伙伴密钥(带批发价):与正式环境一样通过签发链接领取,签发页面在沙盒主机上打开。

余额

POST /v1/sandbox/top-up,请求体为 {"amount_usdt": "100.00"}(权限范围 wallet:read):入账流程与链上转账相同,流水中会生成 top_up 操作并推送 balance.updated 事件。单次最多 10000 USDT,访客密钥单次最多 1000 USDT、每天最多 5000 USDT;network 为 GET /v1/balance/top-up-addresses 中的网络。

商品目录

与正式环境相同:同样的 product_id,以及按同一锚定汇率换算的网站零售价(字段 price_usdt)。库存为虚拟卡密,会自动补充。

用于调试的错误
  • 商品「缺货」:始终返回 409 40002 out_of_stock
  • 商品「队列已满」选择由我方银行卡代付时:返回 409 40003 card_payment_queue_full
  • 订单金额超过余额:返回 402 30001 not_enough_balance

请勿向沙盒转入真实 USDT

沙盒的充值地址并非真实的链上地址:真实转账不会入账。

开通场景

开通结果由客户信息中的标记决定:对于各类 ID(claude_org_id、grok_user_id、x_account_id)以及 chatgpt_session 中的 account.id,标记是 UUID;对于 claude_session_key,标记是 sandbox-<场景>。没有标记即为成功。结果由后台步骤产生,以 order.updated 事件推送,通常需要一到两分钟。

用于 claude_org_id、grok_user_id、x_account_id 以及 chatgpt_session 中的 account.id用于 claude_session_key,替代 sk-ant-sid02-…
场景结果 · 客户信息中的标记
ok
查询供应商后成功:activation.activated。任何不含标记的值也会得到此结果
00000000-0000-4000-8000-000000000001sk-ant-sid02-sandbox-ok
has-plan
已有套餐:reason_code: account_has_plan,等待客户;force 可覆盖开通
00000000-0000-4000-8000-000000000002sk-ant-sid02-sandbox-has-plan
session-invalid
信息无效:session_invalid,需要重新提供
00000000-0000-4000-8000-000000000003sk-ant-sid02-sandbox-session-invalid
workspace
提供的是工作空间而非个人账号:account_workspace
00000000-0000-4000-8000-000000000004sk-ant-sid02-sandbox-workspace
verification
需通过链接验证:activation.verification_required,随后 activated
00000000-0000-4000-8000-000000000005sk-ant-sid02-sandbox-verification
manual
人工队列:activation.manual——沙盒中不会有人处理
00000000-0000-4000-8000-000000000006sk-ant-sid02-sandbox-manual
key-used
卡密已在供应商处被使用:activation.failed,附 key_used
00000000-0000-4000-8000-000000000007sk-ant-sid02-sandbox-key-used

由我方银行卡代付

流程会自动走完,由系统代替我方人员操作:

客户邮箱waiting · login_link任意 https://claude.ai/… 链接completed

「我们提供的新账号」直接就绪,无需提交任何信息:虚拟账号信息见 GET /v1/orders/{order_id}。

在浏览器中试用

沙盒只响应来自两个页面的浏览器请求:API 参考 https://api.astrum.shop/v1/docs 和文档控制台 https://astrum.shop/docs。沙盒自身的 API 参考和指南会跳转(308)到正式环境主机和官网。

本页内容是否有帮助?
发现错误?在 Telegram 联系我们