沙盒
独立的一套环境,使用测试 USDT。接口契约与正式环境 API 相同:一个环境的密钥不能在另一个环境中使用(401)。
沙盒密钥
地址与密钥
https://sandbox-api.astrum.shop/v1 ask_test_…在此使用正式环境密钥会返回 401whsec_test_…sandbox: true用于与正式环境事件区分沙盒限额
访客密钥无需申请即可领取,因此单独设有比正式环境更严格的限额。限额同时按密钥和 IP 地址计算:同一地址的多个密钥共享同一个限额。
超出限额时返回 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/ 的「正式密钥需申请」表单中提交申请。
沙盒的工作方式
访客密钥:通过上方按钮、命令 curl -fsSL https://astrum.shop/,或不带密钥调用 POST /v1/sandbox/ 领取。合作伙伴密钥(带批发价):与正式环境一样通过签发链接领取,签发页面在沙盒主机上打开。
POST /v1/sandbox/,请求体为 {"amount_usdt": "100.00"}(权限范围 wallet:read):入账流程与链上转账相同,流水中会生成 top_up 操作并推送 balance.updated 事件。单次最多 10000 USDT,访客密钥单次最多 1000 USDT、每天最多 5000 USDT;network 为 GET /v1/balance/ 中的网络。
与正式环境相同:同样的 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-…activation.activated。任何不含标记的值也会得到此结果00000000-0000-4000-8000-000000000001sk-ant-sid02-sandbox-okreason_code: account_has_plan,等待客户;force 可覆盖开通00000000-0000-4000-8000-000000000002sk-ant-sid02-sandbox-has-plansession_invalid,需要重新提供00000000-0000-4000-8000-000000000003sk-ant-sid02-sandbox-session-invalidaccount_workspace00000000-0000-4000-8000-000000000004sk-ant-sid02-sandbox-workspaceactivation.verification_required ,随后 activated00000000-0000-4000-8000-000000000005sk-ant-sid02-sandbox-verificationactivation.manual——沙盒中不会有人处理00000000-0000-4000-8000-000000000006sk-ant-sid02-sandbox-manualactivation.failed,附 key_used00000000-0000-4000-8000-000000000007sk-ant-sid02-sandbox-key-used由我方银行卡代付
流程会自动走完,由系统代替我方人员操作:
waiting · login_link任意 https://claude.ai/… 链接completed「我们提供的新账号」直接就绪,无需提交任何信息:虚拟账号信息见 GET /v1/orders/。
在浏览器中试用
沙盒只响应来自两个页面的浏览器请求:API 参考 https://api.astrum.shop/ 和文档控制台 https://astrum.shop/。沙盒自身的 API 参考和指南会跳转(308)到正式环境主机和官网。
