VPS API，用 JSON REST 自动化云服务器

是的，VPS API对所有会员免费。API密钥发放和请求均不收费，通过API创建的服务器和选项价格与通过控制面板创建的相同。任何完成首次付款的会员均可立即在API密钥页面创建密钥。

完成首次付款后，即可在API密钥页面(/api-key)创建密钥。使用Bearer方案将密钥放入每个请求的Authorization头。该密钥可操作整个账户，请勿存入代码仓库，应保存在环境变量或密钥管理工具中。

可以读取在售列表(GET /catalog)、读取服务器列表和单台信息(GET /servers、GET /servers/{id})、创建服务器(POST /servers)、开机、关机和重启(start、stop、reboot)、续费一个月(renew)、删除(DELETE /servers/{id})。请求示例和响应格式见 API 文档。

一个密钥每分钟最多可请求300次。超出限制会返回 429 状态码和 rate_limited 错误，在脚本中处理为稍等后重新发送即可。查询服务器列表和电源管理等日常自动化在此限制内运行绰绰有余。不按请求次数收费。

当POST /servers请求成功时，系统将处理所选计费周期的付款并创建服务器。若创建失败，款项将退回账户余额。

创建服务器请求的响应中会包含一次 root_password 值。收到响应后请立即保存到安全的地方。在控制面板中也可在7天内再次查看，同时发送 SSH 密钥编号的话，无需密码即可用密钥直接连接。可以用响应中的 ipv4 值立即开始 SSH 连接，便于与部署脚本衔接。

可以。在创建服务器请求的 ssh_key_id 中填入已添加的 SSH 密钥编号，新服务器就会放入该密钥。密钥只需在控制面板的 SSH 密钥页面添加一次，指纹以与 ssh-keygen 相同的方式显示，一眼就能确认是哪个密钥。密钥编号定好后可以重复使用。

只要能发送 HTTP 请求，任何语言和工具都可以。可以用 curl 直接测试，在 Python 的 requests、Node.js 的 fetch、GitLab CI 的脚本步骤、Terraform 的 HTTP 请求功能中，用相同的地址和请求头调用。响应都是 JSON，结果易于读取。

错误会以非 2xx 的状态码加含 error 值的 JSON 返回。密钥错误为 unauthorized，缺少值为 bad_request，余额不足为 not_enough_balance，请求与服务器状态不符为 wrong_state，原因清晰区分，程序可按情况处理。

会。API 和控制面板操作的是同一个账户和同一批服务器。通过 API 创建的服务器会直接显示在控制面板列表中，可在控制面板中重装操作系统或查看密码。每个账户10台服务器的上限也同时适用于两种方式。手动操作和代码操作混用，状态和付款日也始终一致。