请求频率与文件大小限制
请求太频繁或文件太大时如何处理:429、413 状态码,以及请求体和导入文件的大小限制。
本页内容
如果程序请求太频繁,服务器可能要求稍后再试;一次传输的数据太多,请求则会被拒绝。下方说明如何处理。机器人编辑器自身的限制见平台限制。
请求频率
429 Too Many Requests 表示请求过于频繁。请等待后重试;如果再次被拒绝,逐步延长等待时间,例如先等 1 秒,再等 2 秒、4 秒。这称为指数退避(backoff)。批量操作应分散执行,避免同时发出大量请求。
请求体大小
普通 REST 请求的 JSON 请求体上限为 2 MiB。超过时请分批处理,例如分多个批次导入反应。
导入文件大小
导入反应及相关文件的压缩包上限为 64 MiB;含附件的聊天记录压缩包上限为 256 MiB。上传的压缩包大小和解压后的数据总量都会受限。文件过大时请拆成多次导入。
超出限制
- 请求太频繁:收到
429,延迟后重试。 - 请求体太大:根据接口收到
413或400,缩小请求或拆分数据。
接下来
- API 错误:
429和其他状态码。 - 从 sambot 导入:导入大型压缩包。
- 交互式 API 参考:各接口的具体限制。