你的代码能做什么
以下功能现已全部写入 OpenAPI 文档,并注明每个请求所需的 scope。
订购服务器
先通过报价计算服务器价格,再用余额下单。幂等键确保重试的订单只扣费一次。
续费与升级
为服务器续费一个周期,或升级到更大的套餐,均从余额支付。也可以让它自动续费。
控制服务器
启动、停止、重启和重装,设置登录密码,打开浏览器控制台,并跟踪每个操作直到完成。
防火墙
开启或关闭服务器的防火墙,应用预设,并添加、替换或删除入站放行规则。
快照与备份
创建、恢复和删除快照与备份,并为服务器安排计划任务。
Webhook
在服务器就绪、被暂停、解除暂停或删除,以及订单退款时收到通知。每次投递都使用 HMAC-SHA256 签名。
基本规则
- 基础 URL
- https://api.exy.sh/v1
- 认证
- 以 exy_ 开头的 Bearer 令牌,仅限你选择的 scope。有效期最长 365 天。
- 限制
- 每个账户每分钟 60 次请求,所有令牌合计。超出后返回 429 和 Retry-After。
- 错误
- 所有错误格式相同:一个供程序使用的稳定代码,一条供人阅读的消息。
- 兼容性
- 在 /v1 内我们只新增端点、可选字段和响应字段。其他变更都会以 /v2 发布。
文档
指南令牌、scope、限制、错误,以及 curl 和 TypeScript 示例。help.exy.sh/api/use-the-exy-apiAPI 参考每个端点、字段和响应,以及所需的 scope。api.exy.sh/v1/docsOpenAPI 文档机器可读的规范,用于生成客户端和你自己的工具。api.exy.sh/v1/openapi.json
要把服务器卖给自己的客户?查看经销商计划。
预先付款,不会自动续费。