更新日志
API、技能包和文档的变更记录，最新的在前。
更新于 2026年10月8日 · 阅读约需 12 分钟
10月8日2026
质保：通过 API 按订单提交售后申请
新增
POST /v1/orders/{order_id}/claims — 售后申请：问题类型、期望的处理方式（重新开通或退款至余额）、客户账号邮箱和截图。交付后 7 天内可提交，订阅从开通时起算新增
GET /v1/claims 和 GET /v1/claims/{claim_id} — 您的售后申请及处理结果；处理结果通过 order.updated 推送新增订单中的
warranty 字段块：质保截止时间、能否提交申请，以及不能提交的原因新增在账户中查看订单和售后申请：「集成 → 订单」（支持搜索和筛选）和「售后申请」
10月8日2026
文档和 API 文字支持中文
新增中文文档：
astrum.shop/docs?lang=zh ；单文件指南：/v1/guide.md?lang=zh新增合作伙伴语言选择「中文」时，API 响应中面向人的文字（
status_text、customer_instruction、错误的 message）、开通页面和小组件、消息和邮件均使用中文。请求头 Accept-Language: zh 可切换单次请求的语言无变化机器可读字段（
status、错误码、details.problem）在所有语言中保持一致10月8日2026
技能包 2.1.7
新增参考文档「订单」新增质保：申请期限、售后申请
POST /v1/orders/{order_id}/claims 、申请未被受理的原因变更接口契约：新增售后申请接口和订单中的
warranty 字段块；错误的 message 改用合作伙伴的语言无变化规则和模板
下载 2.1.7——旧版本已下架，访问时返回 410，并附最新版本链接。
10月7日2026
充值：地址即时可用，支持 BSC、TON 和 TRON 网络
变更充值地址在商店接入时分配（每个网络一个），分配后立即可用，无需等待 24 小时。如果我们更换地址，会通过 Telegram 或邮件通知您，转到旧地址的款项不会丢失，核对后会入账
变更充值网络为 BSC (BEP-20)、TON 和 TRON (TRC-20)：
GET /v1/balance/top-up-addresses 返回 bsc、ton、tron 地址。在任一网络中均为 1 USDT = 1 $，跨网络调拨的手续费由我们承担变更EVM 地址仅用于 BSC：在其他 EVM 网络（Arbitrum、Base、Polygon…）中转到该地址的款项不会自动入账，核对后会人工入账
新增各网络的入账时间：BSC 约 1 分钟，TON 2–3 分钟，TRON 3–4 分钟
10月7日2026
开通小组件启用新的信息填写窗口
变更开通页面和小组件改为「提交信息 → 开通 → 完成」三步；「粘贴」后在提交前即完成校验（账号和套餐立即可见）；显示开通进度，完成页提供前往服务的按钮、「如何确认」和「返回商店」
新增窗口底部同一行显示「客服」（开通相关问题）和「付款与退款 ↗」（指向您在账户中填写的联系方式）；您的品牌色应用于整个窗口，浅色主题也会应用于开通页面
无变化嵌入代码、
mode、status 事件和 order.updated10月7日2026
技能包 2.1.6
变更参考文档「余额」：充值网络 BSC、TON 和 TRON，各有独立地址；各网络的入账时间；
GET /v1/balance/top-up-addresses 响应示例；在 TON 中转账无需填写备注（memo）变更参考文档「开通」：客户在新的小组件窗口中看到的内容，包括信息填写、带前往服务按钮的完成页、附卖家联系方式的取消页
变更参考文档「沙盒」：沙盒商品目录采用网站零售价
无变化规则和模板
下载 2.1.7——旧版本已下架，访问时返回 410，并附最新版本链接。
10月6日2026
技能包 2.1.5
变更参考文档「余额」：充值地址立即可用
变更规则 10：充值地址和网络只能从
GET /v1/balance/top-up-addresses 获取无变化模板
下载 2.1.7——旧版本已下架，访问时返回 410，并附最新版本链接。
10月6日2026
通过 App Store 或 Google Play 购买的订阅
新增
waiting 状态，status_text 为「该账号的订阅是通过 App Store 或 Google Play 购买的…」：客户账号上的订阅是在应用商店购买的，无法在网站上续订。客户需在应用商店取消订阅，到期后重新提交信息，或改用另一个账号。此前这种情况显示为「工作人员正在处理」变更
claude_org_id 的 customer_instruction：客户账号不能加入任何团队工作空间，无论是自己的还是他人的；如已加入，客户需删除该空间或退出。此前的提示是「切换到个人账号」，但如果组织被封禁，其成员的个人账号也无法付费订阅10月6日2026
技能包 2.1.4
新增参考文档「开通」收录了关于 App Store 或 Google Play 订阅的客户提示文本
变更「您没有登录 ChatGPT」的提示会建议：如果链接是在 Telegram 或其他应用内打开的，请改用 Safari 或 Chrome 打开
变更参考文档「开通」中关于 Organization ID 的客户提示：账号不能加入团队工作空间
无变化规则和模板
下载 2.1.7——旧版本已下架，访问时返回 410，并附最新版本链接。
10月4日2026
客户拒绝身份验证
新增
POST /v1/orders/{order_id}/verification-declined 和操作 verification_declined：客户拒绝进行身份验证。订单关闭，款项立即退回您的余额，是否退还给客户由您处理。服务方未要求验证时返回 60007 verification_not_requested新增小组件和开通页面中，验证按钮下方新增「放弃并退款」，可直接在卡片内确认
变更「去验证」和「我已完成验证」两个按钮合并为一个：跳转到验证页面后，它会自动变为「我已完成验证」
变更因拒绝验证而关闭的订单为
status: canceled，status_text 为「客户拒绝了身份验证，款项已退回您的余额」；会推送 order.updated 和 balance.updated10月4日2026
技能包 2.1.3
新增参考文档「开通」收录了拒绝验证：操作
verification_declined，以及之后订单和余额的变化无变化规则和模板
下载 2.1.7——旧版本已下架，访问时返回 410，并附最新版本链接。
10月3日2026
客户身份验证
新增
POST /v1/orders/{order_id}/verification-done 和操作 verification_done：客户已完成服务方要求的身份验证。服务方未要求验证时返回 60007 verification_not_requested新增
activation.verification_until ：验证链接的有效截止时间（Claude 验证页面的有效期不足 24 小时）变更
activation.verification_link 指向服务方自己的验证页面（Claude 为 inquiry.withpersona.com）或其账号设置；链接过期后则指向账号设置无变化开通页面和小组件会自行展示验证请求，并提供「去验证」和「我已完成验证」按钮
10月3日2026
技能包 2.1.2
新增参考文档「开通」收录了身份验证：
verification_link、verification_until 和操作 verification_done无变化规则和模板
下载 2.1.7——旧版本已下架，访问时返回 410，并附最新版本链接。
10月1日2026
底部弹层式小组件
新增
<astrum-activation> 的 mode="sheet"：页面上只显示「开通订阅」按钮，表单从底部滑出、覆盖在页面之上；在电脑上则以居中窗口打开。点击关闭按钮、点击外部区域或按 Esc 即可关闭，弹层下方的页面不会滚动新增「开通小组件」一节新增「小组件的展示方式」：嵌入页面或底部弹层
变更手机上的小组件更宽，ID 输入框为单行且没有滚动条：形如
9959bd2c-… 的 ID 可以完整显示无变化订单中的链接、脚本、
status 事件，以及按账户中的列表校验网站10月1日2026
技能包 2.1.1
新增参考文档「开通」收录了底部弹层式小组件：页面空间不足时使用
mode="sheet"无变化规则、接口契约和模板
下载 2.1.7——旧版本已下架，访问时返回 410，并附最新版本链接。
10月1日2026
开通页面与小组件
新增
activation.page_url — 订单开通页面的链接（https://activate.astrum.shop/#t=… ）：客户自行提交信息，并可查看状态直至「订阅已开通」。activation 和 card_payment 有该链接，其他交付方式为 null新增小组件
<astrum-activation> — 在您的网站上嵌入同一页面；可使用小组件的网站在账户的「集成 → 开通页面」中添加新增「开通小组件」一节：实时示例、接入方式和外观
无变化自有表单照旧使用
POST /v1/orders/{order_id}/activate ；页面与 API 共享尝试次数10月1日2026
技能包 2.1.0
新增参考文档「开通」以开通页面和小组件开篇：智能体会把
page_url 交给客户，或用小组件代替自建表单变更接口契约和示例中加入
activation.page_url无变化规则和模板
下载 2.1.7——旧版本已下架，访问时返回 410，并附最新版本链接。
9月29日2026
技能包 2.0.1 · Grok：X 账号 ID
新增客户信息类型
x_account_id：用于购买的 X 账号 ID。30 天版 Grok 需要它（在 X 账号上开通 X Premium+ 订阅）。它不是用户名，也不是账号编号：X 只向 x.com 上的书签脚本提供该 ID变更
grok_user_id 也接受 grok.com/api/auth/session 页面的全部文字，我们只从中提取 ID新增Grok 和 X 的信息校验失败原因见「格式错误」中的选项卡；参考文档「开通」和
astrum_check.py 已支持新类型新增「开通」一节的「需要向客户索取的信息」中新增 Grok 选项卡：客户如何获取 Grok 账号 ID 和 X 账号 ID、提供给客户的书签代码，以及电脑、iPhone 和 Android 的操作步骤
变更「开通」一节更紧凑：需要向客户索取的信息按服务分选项卡，客户文本按商品交付方式分组，「格式错误」按信息类型分组；新账号现在也会注明「非工作时间」
变更30 天版 Grok 开通后的
status_text 会说明客户的最后一步：在 Grok 中关联该 X 账号变更
grok_user_id 的 customer_instruction 提供带 ?mwbv=true 的完整地址：不带该参数时，手机上会打开 Grok 应用，而应用中没有显示 ID 的页面下载 2.1.7——旧版本已下架，访问时返回 410，并附最新版本链接。
9月28日2026
更简洁的 API
变更「预付款」→ 余额，金额字段以
_usdt 结尾，编号字段为 order_id、product_id、operation_id、event_id变更一笔订单对应一件商品：
{"product_id"}，商品有多种交付方式时再加 delivery_method；订单号由我们生成，移除了 reseller_ref 和 Idempotency-Key。未收到响应时，先调用 GET /v1/orders（当天订单）变更状态改为单个单词：
completed、waiting、processing、failed、canceled、refunded；给客户的现成文本为 status_text 和 customer_instruction；可执行的操作见 available_actions变更开通改为订单操作：
POST /v1/orders/{order_id}/activate （客户信息和登录链接）、/retry、带 customer_agreed 的 /force新增
POST /v1/orders/{order_id}/cancel ：在商品被取走之前取消订单，款项退回余额变更商品目录中每件商品只有一个
product_id，交付方式见 delivery_methods变更列表按天返回（
?date=），不再使用游标；相关接口：GET /v1/account、/v1/balance、/v1/balance/history、/v1/balance/top-up-addresses 、POST /v1/sandbox/top-up 变更事件精简为三种：
order.updated（完整订单）、balance.updated、balance.low；不再按类型订阅新增余额不足提醒也会通过 Telegram 或邮件发送给您本人
变更错误改为五位数字
code 和 name，见「错误码」表变更合作伙伴条款更新为
reseller_terms.v2 版本：用「余额」代替「预付款」，含义不变；此前签发的密钥仍适用原版本移除报价估算、事件流、
GET /v1/me、/wallet、/ledger、/deposits、/activations/*v1 接口契约直接原地修改：此前尚未有任何正式环境订单通过 API 下单。9月28日2026
技能包 2.0.0
变更规则、参考文档、Python 和 Node 模板以及
astrum_check.py 已适配新契约：单件订单（不再使用自定义订单号）、订单操作、余额、三种事件、数字错误码变更模板中的客户端不再盲目重试
POST /v1/orders，而是先调用 GET /v1/orders新增参考文档「余额」取代「充值」；「开通」中新增按状态划分的客户文本
下载 2.1.7——旧版本已下架，访问时返回 410，并附最新版本链接。
9月27日2026
人人可用的沙盒与一条命令接入
新增无需申请即可领取沙盒密钥：通过「沙盒」一节中的按钮、接入命令或
POST /v1/sandbox/keys ；访客密钥使用零售价，并有自己的限额新增
curl -fsSL https://astrum.shop/connect | sh ：一条命令完成密钥、AI 智能体技能包、.env 和测试订单（见「一条命令接入」一节）新增
GET /v1/me 中的 partner.guest；错误码 sandbox_key_cap、sandbox_day_cap 和 sandbox_closed9月27日2026
技能包 1.0.3
新增第 6 步：没有沙盒密钥时，智能体会自行领取访客密钥并写入
.env，且不会将其打印出来变更参考文档「沙盒」：访客密钥及其限额；错误码表中加入访客密钥相关错误码；接口契约中加入
partner.guest无变化规则和模板
9月26日2026
全新文档
变更「由我方银行卡代付」「事件与 Webhook」「沙盒」「开通」「错误」「限额」「API 密钥」和「通用约定」改用卡片、流程链和配色展示；沙盒标记改为单行显示
新增错误码表中的补充说明（
reason）直接列在错误码旁，每个事件都附有说明新增「联系客服」：在文档任意页面都可通过我们的 Telegram 机器人联系客服
9月26日2026
技能包 1.0.2
变更参考文档由相同的章节生成，去掉了网页展示用的标记；事件附有说明，错误的补充说明来自错误码表
修复规则 8 和 Webhook 接收端模板：按已验证请求体中的
id 去重，而不是按请求头 X-Astrum-Event-Id，因为该请求头不在签名范围内新增开通操作错误
invalid_state · manual：开通由我们的工作人员处理，不再接受重试和新的信息无变化接口契约
9月26日2026
文档上线官网
新增指南和 API 参考迁至
https://astrum.shop/docs ：按章节分页，支持搜索新增CURL、Python 和 Node 示例，以及直连沙盒的在线试用控制台
新增每个接口都有字段说明和各自的错误码（规范中的
x-error-codes）变更
https://api.astrum.shop/v1/guide 跳转至此9月26日2026
技能包 1.0.1
变更参考文档各章节增加小标题；「订单与商品」改为分步说明，并附接口错误表；示例增加标题
无变化规则和接口契约
9月24日2026
API 首个版本
新增商品目录、报价估算和使用预付款下单，商品通过
GET /v1/orders/{id} 获取新增基于客户信息的开通、card_pay、
force新增预付款和专属充值地址
新增事件流和带签名的 Webhook、API 参考和指南
9月24日2026
技能包
astrum-partner-api 1.0.0新增规则、基于指南和接口规范生成的参考文档、Python 和 Node 模板、检查脚本
astrum_check.py新增带测试美元和开通场景的沙盒
本页内容是否有帮助？
发现错误？在 Telegram 联系我们