频次限制
Rate Limit(频次限制)是在设定的时间间隔内强制发送到服务器的 API 请求数量的因素。允许客户端(应用/用户/设备)发送一定数量的频率限制内的 API。一旦超过频次限制,当满足以下条件时,客户端被锁定并且不允许向服务器发送任何 API 请求。
限制持续时间或锁定持续时间是超过频次限制后客户端被锁定的时间区间。
计数限制是计数间隔内允许的 API 数量。频次限制被分为计数间隔。例如,在下面的示例中,频次限制被分为 10 秒计数间隔。突发限制允许您在一定次数(突发数)内超出频次限制。由于客户端 2 超出了限制,因此其被锁定一段时间(限制持续时间),并将暂时被阻止进行进一步的 API 请求。要查看您的频次限制,请访问 https://<yourportal>/rate_limits。例如,https://portal-dev.telit.com/rate_limits
例如:下图显示具有以下频次限制的 2 个客户端。 | |
限制持续时间 | 2h |
计数限制 | 100 |
计数间隔 | 10s |
突发限制 | 200 |
突发数 | 3 |
突发间隔 | 1h |
客户端 1
客户端 1 在设定的突发间隔 (1h) 内超出计数限制 (100) 3 次(211、190、206)并超出突发限制 (200) 2 次(211、206)
客户端 2(已锁定)
客户端 2 在设定的突发间隔 (1h) 内超出计数限制 (100) 7 次(163、209、176、114、221、122、211)并超出突发限制 (200) 3 次。由于超出突发限制 3 次,因此客户端在限制持续时间 (2h) 内被锁定。在限制持续时间期间,如果客户端发送任何 API 请求,客户端将收到错误消息,指出已超出 API 频次限制。