限流策略

GET/v2/system/rate-limits

查询当前账号在各接口分组上的限流档位。

限流采用令牌桶算法，桶容量为「每秒速率 × 突发倍数」。响应头 X-RateLimit-Remaining 与 X-RateLimit-Reset 随每个请求返回。

Bearer Token system:read api.demo.acme-cloud.dev

响应

2 种状态

200 OK

响应示例

{
  "tiers": [
    {
      "group": "auth",
      "limit": "10/min",
      "burst": 20,
      "scope": "per-ip"
    },
    {
      "group": "users.read",
      "limit": "300/min",
      "burst": 60,
      "scope": "per-token"
    },
    {
      "group": "compute.write",
      "limit": "60/min",
      "burst": 10,
      "scope": "per-token"
    },
    {
      "group": "metrics.query",
      "limit": "60/min",
      "burst": 5,
      "scope": "per-token"
    }
  ],
  "notice": "超限返回 429，并携带 Retry-After 头部。"
}

代码示例

cURL

curl -i -X GET 'https://api.demo.acme-cloud.dev/v2/system/rate-limits' \
  -H 'Accept: application/json'