API、命令行和 Terraform

1. 创建 API 密钥

在面板的“API 密钥”页面创建密钥。密钥绑定到单个账户，权限不会超过您在该账户中的角色；可以设为只读、限定特定产品，并设置到期日期。完整密钥仅在创建时显示一次。

2. 您的第一个请求

在 Authorization 请求头中发送密钥：

curl -H "Authorization: Bearer v360_..." \
  https://api.haizora.com/v1/portal/servers

须知

• 只读密钥只能发送读取请求，在账户中的表现与只读角色相同。
• 写入密钥以创建者当前的角色运行；如果创建者被移出账户，密钥将立即失效。
• 不能使用密钥创建其他密钥；团队和邀请操作只能在面板中进行。
• 错误响应包含 error.code 和 error.message 字段。
• 每个密钥每分钟最多可发送 300 个请求；超出后将返回 429 以及 Retry-After 响应头。

命令行工具：v360正在准备发布

一个无依赖的 Node.js 工具，支持登录、列出服务器和电源操作、DNS 记录以及发布函数（Node 18 及以上）。

v360 login                      # paste a v360_... token
v360 servers list
v360 servers power <id> reboot
v360 dns list example.com
v360 dns add example.com A www 203.0.113.10 --ttl 300
v360 workers deploy ./worker.js --name hello

Terraform Provider正在准备发布

支持服务器、托管数据库、无服务器函数和 DNS 记录资源。服务器和数据库资源会创建订单；发票支付后才会开通服务。

provider "vadi360" {}   # VADI360_TOKEN

resource "vadi360_dns_record" "www" {
  domain_id = data.vadi360_domain.main.id
  type      = "A"
  name      = "www"
  value     = "203.0.113.10"
}

resource "vadi360_function" "hello" {
  name = "hello"
  code = file("worker.js")
}

命令行工具和 Terraform Provider 尚未发布到 npm 和 Terraform Registry。在此之前，您可以直接使用 REST API。

API 参考

此列表由 OpenAPI 3.1 文档生成。您可以下载该文档，使用 Postman、Insomnia 或 openapi-generator 生成客户端。