API 参考

合作伙伴 API 共 22 个接口：请求字段、响应、错误码和示例。每个接口都配有沙盒控制台。

基础地址

https://api.astrum.shop/v1

密钥通过请求头 Authorization: Bearer ask_live_… 传递，仅限服务器端。

沙盒

https://sandbox-api.astrum.shop/v1

密钥 ask_test_…，测试 USDT，商品与正式环境相同。了解工作方式

OpenAPI 3.1 规范

账户

您在 API 中的身份：合作伙伴、API 密钥、是否为沙盒以及限额。详见指南。

GET合作伙伴、API 密钥与限额/v1/account

余额

余额、今天还能花费多少、余额流水和充值地址。详见指南。

GET余额及今天还能花费的金额/v1/balancePATCH余额低于指定金额时提醒/v1/balanceGET按日查询余额流水/v1/balance/historyGETUSDT 充值地址/v1/balance/top-up-addresses

商品目录

商品、交付方式、价格和库存情况。详见指南。

GET商品目录（每 1 分钟更新一次）/v1/catalog

订单

从余额付款购买单件商品、获取商品、按日列出订单和取消订单。详见指南。

POST购买一件商品/v1/ordersGET按日查询订单/v1/ordersGET订单及商品/v1/orders/{order_id}POST取消并退款/v1/orders/{order_id}/cancel

开通

订单操作：提交客户信息、重试，以及在现有套餐上强制开通。详见指南。

POST提交客户信息/v1/orders/{order_id}/activatePOST使用已提交的信息重试/v1/orders/{order_id}/retryPOST在当前订阅上强制开通/v1/orders/{order_id}/forcePOST客户已完成身份验证/v1/orders/{order_id}/verification-donePOST客户拒绝身份验证/v1/orders/{order_id}/verification-declined

质保

售后申请：重新开通或退款，处理结果通过 Webhook 推送。详见指南。

POST提交售后申请/v1/orders/{order_id}/claimsGET售后申请列表/v1/claimsGET售后申请/v1/claims/{claim_id}

Webhook

地址、签名密钥和测试事件。详见指南。

GET地址与投递概况/v1/webhookPUT设置地址/v1/webhookPOST生成新签名密钥；旧密钥在 24 小时内仍用于签名/v1/webhook/rotate-secretPOST测试事件/v1/webhook/test

通用错误

任何使用密钥的接口都可能返回这些错误。各接口特有的错误见接口页面，完整列表见「错误码」章节。

40110001API 密钥未被接受：密钥缺失、不正确或已被吊销
40310002该密钥无权执行此操作
40310003请求来源地址不在该密钥的允许列表中
40310004API 只能从服务器调用，不能从浏览器调用
40310005合作伙伴账户已暂停，请联系客服
42920001请求过于频繁，请稍后重试
50390002API 暂时关闭
50090001内部错误，请稍后重试