速率限制 & 额度
哪些有上限
你的套餐限制四样东西,都可在 GET /v1/account 中看到:监控目标数、关键词数、并发 WebSocket 连接数和每分钟请求数。前两项超限返回 402 plan_limit 并附 details.resource,第三项以 4002 关闭连接,第四项返回 429 rate_limited 并附 Retry-After 头部。
头部
每个经过认证的响应都会告诉你当前的用量位置,客户端可以在被拒绝之前主动退避:
| 头部 | 含义 |
|---|---|
X-RateLimit-Limit | 此密钥每分钟允许的请求数 |
X-RateLimit-Remaining | 当前这一分钟内还剩多少 |
X-RateLimit-Reset | 窗口重置的 Unix 时间 |
X-Credits-Used-Today | 自 00:00 UTC 起按需读取消耗的额度 |
X-Request-Id | 报给我们,我们就能在日志中找到这次请求 |
X-Response-Time | 我们的处理耗时,毫秒 |
ETag | JSON 响应的弱校验值;作为 If-None-Match 发回 |
Idempotent-Replay | 当响应是对同一 Idempotency-Key 早先请求的重放时为 true |
Retry-After | 需要等待的秒数,每个 429 都带 |
Location | 已创建或已排队资源的位置,出现在 201 和 202 上 |
额度
流式传输不计量——空闲连接和繁忙连接成本相同,连接上的帧也不计入请求预算。读取一节下的按需 REST 读取会消耗额度,每次调用 1 或 2 点,各端点处有标注;GET /v1/account/usage 显示你的每日总量。