开发者 API

用你自己的代码管理服务器。

附带 OpenAPI 文档的 REST API。订购、续费和升级服务器,控制它们,并通过带签名的 Webhook 获得通知。

$ export EXY_API_TOKEN="exy_…"
$ curl "https://api.exy.sh/v1/servers?limit=10" \
-H "Authorization: Bearer $EXY_API_TOKEN"

每次列出十台服务器。令牌在控制面板的 设置 → API 中创建。

你的代码能做什么

以下功能现已全部写入 OpenAPI 文档,并注明每个请求所需的 scope。

订购服务器

先通过报价计算服务器价格,再用余额下单。幂等键确保重试的订单只扣费一次。

续费与升级

为服务器续费一个周期,或升级到更大的套餐,均从余额支付。也可以让它自动续费。

控制服务器

启动、停止、重启和重装,设置登录密码,打开浏览器控制台,并跟踪每个操作直到完成。

防火墙

开启或关闭服务器的防火墙,应用预设,并添加、替换或删除入站放行规则。

快照与备份

创建、恢复和删除快照与备份,并为服务器安排计划任务。

Webhook

在服务器就绪、被暂停、解除暂停或删除,以及订单退款时收到通知。每次投递都使用 HMAC-SHA256 签名。

基本规则

基础 URL
https://api.exy.sh/v1
认证
以 exy_ 开头的 Bearer 令牌,仅限你选择的 scope。有效期最长 365 天。
限制
每个账户每分钟 60 次请求,所有令牌合计。超出后返回 429 和 Retry-After。
错误
所有错误格式相同:一个供程序使用的稳定代码,一条供人阅读的消息。
兼容性
在 /v1 内我们只新增端点、可选字段和响应字段。其他变更都会以 /v2 发布。

文档

要把服务器卖给自己的客户?查看经销商计划。

离你的服务器,只差一次付款。

Windows 或 Linux,五个机房,无订阅。

提个问题
系统
套餐
机房
 

预先付款,不会自动续费。