开发7 分钟

API 参考

通过 API 管理域名、规则、证书与实时指标。

建议先在测试环境完成本指南,再逐步应用到生产环境。
01

创建 API 令牌

在控制台创建最小权限令牌。建议为自动化、监控和部署流程分别创建令牌并定期轮换。

  • 仅授予所需站点范围
  • 选择最小读写权限
  • 不要将令牌提交到代码仓库
02

请求接口

所有请求均使用 Bearer 令牌鉴权,并以 JSON 格式返回结果。

CONFIG
curl https://api.1dun.example/v1/sites \
+  -H "Authorization: Bearer $ONE_DUN_TOKEN" \
+  -H "Content-Type: application/json"
03

处理响应

使用请求 ID 关联日志与支持工单。对于限流响应,请遵循 Retry-After 头并使用指数退避。