快速开始

更新于 2026年10月8日 · 阅读约需 2 分钟
Markdown
API 基础地址
https://api.astrum.shop/v1
所有请求均为 JSON，响应不缓存（no-store）。
携带密钥的请求头
Authorization: Bearer $ASTRUM_KEY
密钥只能从环境变量读取。正式密钥 ask_live_… 通过一次性链接签发，详见「API 密钥」一节。
沙盒
https://sandbox-api.astrum.shop/v1
无需申请即可获得 ask_test_… 密钥和测试 USDT，详见「沙盒」一节。
接口规范
https://api.astrum.shop/v1/openapi.json
OpenAPI 3.1，可据此生成客户端。
API 参考
https://astrum.shop/docs/reference?lang=zh
全部接口，附响应示例和「在沙盒中试用」按钮。
单文件文档
https://api.astrum.shop/llms-full.txt
供 AI 智能体使用：完整的指南与接口约定（俄文版，AI 智能体可直接阅读）。

更快的方式：一条命令

在项目目录中运行 curl -fsSL https://astrum.shop/connect | sh，即可一次完成密钥、AI 智能体技能包、.env 和沙盒测试订单。各步骤的具体说明见「一条命令接入」一节。

首次请求

curl -s https://api.astrum.shop/v1/account -H "Authorization: Bearer $ASTRUM_KEY"
curl -s https://api.astrum.shop/v1/balance -H "Authorization: Bearer $ASTRUM_KEY"
curl -s https://api.astrum.shop/v1/catalog -H "Authorization: Bearer $ASTRUM_KEY"
curl -s https://api.astrum.shop/v1/orders -H "Authorization: Bearer $ASTRUM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "…"}'

订单完整流程

  1. 商品目录 GET /v1/catalog：商品、交付方式、USDT 价格和库存情况。
  2. 下单 带上 product_id 调用 POST /v1/orders：价格从余额中扣除，订单立即获得状态。一件商品对应一笔订单。
  3. 卡密或账号 GET /v1/orders/{order_id} 返回商品（key 或 account）。
  4. 在客户账号上开通订阅 状态为 waiting 的订单需要客户信息（activation.customer_data_type）；请通过 POST /v1/orders/{order_id}/activate 提交。
  5. 后续跟踪 通过推送到您 Webhook 的 order.updated 事件或调用 GET /v1/orders/{order_id} 跟踪订单，直到状态变为 completed。

密钥权限范围

GET /v1/account 会显示合作伙伴信息、密钥名称、是否为沙盒密钥以及限额。密钥能做什么，由它的权限范围（scope）决定：

权限范围 允许的操作
catalog:read 商品目录
orders:write 购买与取消订单
orders:read 订单及商品、按日订单列表
activations:write 提交客户信息、重试、覆盖现有订阅开通
wallet:read 余额、余额流水、充值地址；余额不足提醒
webhooks:manage Webhook 地址、签名密钥、测试事件（需同时拥有 orders:read 和 wallet:read：Webhook 会推送订单和余额）

订单在创建时立即从余额付款

POST /v1/orders 在同一操作中扣款并交付商品（见「订单与商品」一节）。余额通过 USDT 转账充值（见「余额与充值」一节）。

本页内容是否有帮助？
发现错误？在 Telegram 联系我们
上一篇一条命令接入下一篇集成规则