v3.1
2026年9月符合市场习惯的可选服务名称
services 和 catalog 操作现在可接收可选语言代码,以返回十种受支持语言中采用精选的市场术语整理的服务名称。显式请求会加入规范名称和实际语言元数据;译名缺失或过期时会安全回退到英文。未传入 language 时,旧版英文响应结构保持不变。管理员可以审核或细化每个名称。
v3 API 的破坏性变更与值得注意的变更。我们遵循 semver ——增量式变更(新增可选参数、新增 action、响应中新增字段)在同一大版本内发布;破坏性变更进入新的大版本。
services 和 catalog 操作现在可接收可选语言代码,以返回十种受支持语言中采用精选的市场术语整理的服务名称。显式请求会加入规范名称和实际语言元数据;译名缺失或过期时会安全回退到英文。未传入 language 时,旧版英文响应结构保持不变。管理员可以审核或细化每个名称。
/api/v3 成为规范端点,也是熟悉 reseller 契约的基础 URL 直接替代。v3 新增可选精确键、60 秒旧客户端保护、高级目录、数字 ID、refund_quote、account_status、单个或顺序批量取消以及签名 webhook。API 吞吐量现在由 lifetime successful spend 等级决定,并使用账户全部密钥共享的单个 60 秒滚动窗口。/api/v1 和 /api/v2 是当前同一契约的完全别名。
新增分页 catalog 和只读 refund_quote 操作,扩展 add 和 status 元数据,为普通 API 订单增加 15 秒取消窗口,并为自最初创建起 7 天后仍未解决的普通订单提供全额退款。API Webhook 事件现在携带稳定的事件 id;同一批次重试时 deliveryId 保持不变,而每次重试都会获得新的时间戳和签名。Webhook 仍会尽力投递并重试,但不保证持久的至少一次投递。
新增了 Google、Rumble、Audiomack、Tumblr、Kwai、Clubhouse、Vimeo、Deezer、Tidal、Apple Music、Quora 和 GitHub 的服务。它们会像其他服务一样出现在 services action 中,并各自拥有一个专属的公开平台页面。无需改动客户端——新的服务 ID 会直接出现在目录中。
不可用服务会拒绝 action=add,而不会静默接受或排队新订单。请刷新目录并选择可用服务后再重试。
add action 现在接受受支持的、与服务类型相关的可选字段,例如启动延迟和按类型区分的互动选项。服务类型已定义的字段继续沿用其文档含义。
对于 dripfeed=true 的服务,add action 接受成对使用的 runs 和 interval。总交付量为 quantity × runs,且不得超过服务上限。非滴灌服务会拒绝这两个字段。
推出采用表单编码的 v2 action API,包含速率控制、带重试的签名尽力而为 webhook 和幂等下单。当前 v1 和 v2 URL 是 v3 合约的别名,并使用文档所述的账户共享上限。