关于createEnvelope与getEnvelope端点的重试协议咨询

一、推荐的重试协议 #

• 针对createEnvelope接口：
  这是写操作接口，重试前必须保证请求幂等。如果你的请求带有唯一标识（比如自定义的request ID，且接口支持基于该ID的幂等校验），可以采用指数退避策略重试：首次重试间隔1秒，之后每次间隔翻倍（2秒、4秒……），最多重试3-5次，避免持续冲击服务端。如果请求不具备幂等性，除非能100%确认请求未被服务端处理（比如收到明确的"请求未被接收"类错误），否则绝对不要盲目重试，防止重复创建信封。
• 针对getEnvelope接口：
  这是读操作接口，天然具备幂等性，推荐采用固定间隔或指数退避策略重试，最多重试3-5次即可。这类接口的失败大多来自临时网络波动、服务端瞬时过载等问题，重试大概率能成功。

二、400错误码的重试判断 #

400是客户端错误码，但并非所有情况都不能重试，要结合具体错误信息区分：

• 无需重试的场景：如果错误信息明确指向客户端逻辑问题，比如参数格式错误、缺失必填字段、权限不足、目标信封ID不存在等，重试只会重复失败，应该先修正请求内容或权限后再重新发送。
• 可以重试的场景：如果错误信息提示是临时问题，比如"服务端暂时无法处理请求，请稍后重试"、"请求超时"这类模糊的临时异常，或者遇到服务端误返回400的情况（比如实际是服务端内部问题但错误返回了400），可以尝试有限次数的重试。

内容的提问来源于stack exchange，提问作者theHizzle