API 于 7 月 2 日退出测试版。它于 6 月随平台 5.4 版发布，自 2 月起作为邀请测试版运行，仅超过四百个账户，自 4 月以来接口形状未变。有版本、有文档，并与控制面板享受相同的可用性承诺。
说它迟到算是客气了。原因并不神秘：一个位于需要三分半钟才能构建服务器的配置系统之上的接口，只会是一个用于轮询加载指示器的接口。我们首先在 2025 年重写了队列，这个顺序是经过深思熟虑的，而非运气。
功能
| 分组 | 可执行操作 | 说明 |
|---|---|---|
| 实例 | 创建、调整配置、重建、快照、恢复、销毁 | 在线升级配置可用，缩减配置需一次重启 |
| 镜像 | 列出操作系统目录，通过 URL 注册自定义 ISO | 自定义 ISO 安装仍是手动的，且仍然缓慢 |
| 网络 | 添加 IPv4、编辑反向 DNS、请求 IPv6 /48 | 代理委托，永不代理转发 |
| 过滤 | 读取攻击事件，推送 DDoS Pro 的第 7 层规则 | 基础过滤无可配置项 |
| 计费 | 读取余额、列出发票、开具充值发票 | 无卡字段，因为无卡 |
| 事件 | 轮询事件日志或注册 webhook | 使用每账户密钥签名 |
所有内容均为 HTTPS 上的 JSON，面板可展示的每个对象，API 也可返回。不存在仅为 Web 界面保留的功能层级。这一承诺对我们有成本：面板现在使用与你相同的公开端点，因此 API 故障即面板故障，我们能立即发现。
认证
令牌在面板中创建，设置范围，且仅显示一次。不支持密码认证、会话 cookie，也不会重定向到身份提供商——我们本已竭尽全力不收集这些数据，再去信任第三方实属不智。
令牌具有读、写或计费范围，可选限定于单个站点，可选限定于实例列表，并设置过期时间。默认六十天。令牌可单独撤销，撤销在边缘节点两秒内生效。当构建服务器被不知道其内容的人重建时，这比听起来更重要。
由于这里的账户只是电子邮件地址和密码哈希，没有可获取的客户对象。API 中没有姓名字段、地址字段、公司字段或税务字段，原因与 注册表单 不包含这些字段完全相同。
速率限制、幂等性、错误
每分钟六百次读操作和六十次写操作，按令牌而非账户计数，因此一个吵闹的脚本不会耗尽其他自动化的配额。限制在每个响应（包括成功响应）的头部中返回。
每个写操作都接受幂等键。使用相同键重试创建操作，将返回原始实例，而非额外计费的新实例。这是测试者感谢最多的功能，这让你了解到行业其他参与者如何处理配置超时。
错误包含文档化的机器代码、一句人能读懂的话，以及一个请求标识符。将标识符粘贴到工单中，支持人员无需你重现即可看到你所见的相同请求。
故意不做的事
- 永不涉及法币。 计费端点读取余额并开具充值发票。结算仍由 OxaPay 和您选择的链处理，如 支付页面 所述。
- 无子账户或角色。 持续被要求。不构建，因为显而易见的实现意味着持有谁为谁工作的结构，而我们宁愿提供可过期的限定令牌，让您自行维护组织架构。
- 无自动伸缩。 实例是在真实硅片上的专用核心，而非我们可以凭空变出的池。您可以按自己的计划创建和销毁；我们不会假装底层有弹性抽象。
- 无 SDK 矩阵。 一个参考客户端，纯 HTTP 作为契约。六个维护不佳的语言绑定会比文档更快退化。
期望您发现的问题
测试版发现九个值得修复的错误，其中三个以有趣的方式属于我们，另外六个是文档在说谎。若您发现第十个，测试中违反速率限制是允许且预期的，支持人员更希望得到请求标识符而非截图。
参考文档位于 文档。5.4 版的变更日志列出了 2 月至 4 月间形状变化的七个端点，这些是版本一内唯一的破坏性更改。