功能与面板完全一致
控制面板中的每项操作都能通过 API 完成，从重装系统、电源操作到救援模式和反向 DNS。
API 与 Terraform
用代码自动化管理全部裸金属服务器
控制面板里能做的，通过 HTTPS 都能做。你可以直接调用 REST API，也可以在 Terraform 中声明服务器，每项变更在应用前都能先行审阅。
# Read the token without leaving it in your shell history
read -rsp "API token: " FLEXDEDI_TOKEN && export FLEXDEDI_TOKEN
# List servers with their plan, location and status
curl -s https://api.flexdedi.com/v1/servers \
-H "Authorization: Bearer $FLEXDEDI_TOKEN" \
| jq '.data[] | {id, plan, location, status}'
# Reboot one server
curl -s -X POST https://api.flexdedi.com/v1/servers/srv_7f3a/actions/reboot \
-H "Authorization: Bearer $FLEXDEDI_TOKEN"API 与 Terraform亮点
Bearer 令牌认证
每个请求都在 Authorization 请求头中携带 API 令牌进行认证，令牌请存放在你的密钥库中。
Terraform Provider
将服务器声明为资源，用 terraform plan 审阅变更，并把所有服务器纳入版本控制。
基于 HTTPS 的纯 JSON
REST 资源按版本统一位于 /v1 下，可轻松通过 curl、脚本、CI 流水线或任意 HTTP 客户端调用。
工作原理
API 与 Terraform，分步详解。
- 1
创建 API 令牌
在客户中心生成令牌，并作为机密变量保存，例如存放在你的 CI 系统中。
- 2
调用 API
向 https://api.flexdedi.com/v1 发送 JSON 请求，并以 Bearer 凭据的形式携带令牌。
- 3
用 Terraform 实现代码化
在配置中添加 FlexDedi Provider，将服务器作为资源管理。
- 4
自动化全生命周期
在脚本和 CI 任务中完成开通、重装、重启和反向 DNS 设置。
深入了解
API 与 Terraform：你需要了解的要点。
01
可以自动化哪些操作
API 的设计原则是：任何操作都不必依赖控制面板。常见的自动化场景：
- 开通：指定套餐、机房、系统镜像、主机名和 SSH 密钥订购服务器，然后轮询，直到服务器状态变为运行中。
- 重建：在部署流程中用干净镜像重装服务器，或为 CI Runner 定期重装。
- 电源与恢复：健康检查失败时，重启、断电重启或引导进入救援模式。
- 网络：邮件服务器或 Web 服务器上线时，设置反向 DNS。
- 资产清单：列出服务器及其状态，为监控、CMDB 或成本报表提供数据。
下单类调用务必谨慎：创建服务器即开始按月计费，因此任何能订购硬件的自动化流程，都应先经过审批或计划审核。令牌不要提交到源码仓库，应存放在 CI 系统或密钥管理工具中，并记录自动化流程发起的每一次调用。完整的接口列表见 API 参考。
02
Terraform：用版本控制管理全部服务器
Terraform Provider 将 FlexDedi 服务器映射为资源，让裸金属与其他基础设施遵循同一套工作流：编写期望状态，运行 terraform plan 查看将要发生的变更，审阅通过后再应用。
resource "flexdedi_server" "db" {
plan = "pro-32"
location = "fra"
os = "ubuntu-24.04"
ssh_keys = ["ops-laptop"]
}物理服务器按月计费，交付需要几分钟而不是几秒，因此请仔细审阅执行计划：替换一个资源，就意味着一台新服务器或一次重装。为数据库及其他有状态的机器添加 prevent_destroy 生命周期规则，并将状态保存在支持锁定的远程后端中。
每个环境（例如预发布和生产）各保留一份状态，并将该 Provider 与你已在使用的 DNS 和监控 Provider 搭配使用，这样新服务器在同一次 apply 中就能配好对应的记录和检查。再通过 Terraform 输出值，将服务器地址传给 Ansible 或你的配置管理工具。
常见问题
API 与 Terraform，有问必答。
API 能覆盖控制面板的全部功能吗？
能。控制面板中的每项操作都能通过 REST API 完成，原本需要点击的操作都可以写成脚本。接口和参数说明见 API 参考。
如何进行认证？
在每个 HTTPS 请求的 Authorization 请求头中，以 Bearer 令牌的形式携带你的 API 令牌。令牌应存放在密钥管理工具或 CI 系统的机密变量中，切勿提交到源码仓库。
有 Terraform Provider 吗？
有。FlexDedi Terraform Provider 将服务器作为资源管理，你可以用 terraform plan 审阅变更，并把所有服务器纳入版本控制。它可以与你已在使用的 DNS、监控和配置管理 Provider 配合使用。
可以通过 API 订购服务器吗？
可以。你可以按套餐、机房和系统镜像开通服务器，计费方式与其他订单相同：按月计费，无开通费。标有「几分钟内交付」的服务器通常在付款后 15 分钟内交付。