REST API 参考
以编程方式管理源站池、源站、健康检查与调度策略。
最后更新: 2026年9月2日 · 约 8 分钟
身份认证
所有请求都携带一个绑定到单一账户的 Bearer Token。Token 可以限制为只读，也可以限定只能操作特定域名。
- 在 Authorization 请求头中携带 Token
- 按最小权限签发 Token，并定期轮换
- 每次配置变更都会记录到发起变更的 Token
shell
curl https://api.anylb.com/v1/load-balancers \ -H "Authorization: Bearer $ANYLB_TOKEN"查询负载均衡列表
返回账户下的全部负载均衡实例，包含源站池构成、当前调度策略与源站健康状态。
json
{ "data": [ { "id": "lb_2f9c1a", "hostname": "api.example.com", "strategy": "latency", "status": "active", "pools": [ { "id": "pool_7d31", "name": "api-prod", "healthy_origins": 3, "total_origins": 3 } ] } ], "has_more": false}更新源站池
源站池采用整体替换语义：请提交完整的期望源站列表。我们拒绝部分合并，以确保配置不会静默漂移。
shell
curl -X PUT https://api.anylb.com/v1/pools/pool_7d31 \ -H "Authorization: Bearer $ANYLB_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "api-prod", "strategy": "latency", "origins": [ { "address": "api-sin1.internal", "weight": 100 }, { "address": "api-fra1.internal", "weight": 100 }, { "address": "api-iad1.internal", "weight": 0 } ] }'错误与限流
失败请求会返回符合 RFC 9457 的 problem 文档，并附带机器可读的 type 字段。已认证请求每个 Token 每分钟限 1,200 次；被限流时请参考 Retry-After 响应头。
- 400 — 请求体格式错误
- 401 — Token 缺失、过期或无效
- 404 — 该账户下不存在此资源
- 429 — 超出速率限制