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 头并使用指数退避。