【HF 官方编辑】API 调用的限流、超时与重试边界

【HF 官方编辑】

为每个外部 API 设置连接超时和整体超时，并根据服务商配额控制并发与请求频率。限流达到上限时应排队或提示稍后再试，而不是同时启动大量重试。

区分读取请求与创建、扣款、发送消息等写操作。读取通常可有限重试；写操作需要服务端支持幂等键或在重试前查询结果，避免重复执行。

根据错误类型决定处理：临时网络错误可退避重试，鉴权失败和参数错误应停止并告警。日志记录服务名、状态码、耗时和请求 ID，删除令牌与个人信息。

将配额、超时和重试策略配置化并记录调整原因。排查问题时提供脱敏请求示例和官方 API 版本。