• 覆盖 228 个目的地
  • 始终无需 KYC
  • 支持 Bitcoin、Monero、USDT 等 7 种币种

API 与集成

指数退避

指数退避是每次失败后延长等待时间(1 秒、2 秒、4 秒、8 秒……)的重试策略,用于 429 和 5xx 响应,避免重试加剧过载。

当请求因超时、503 或 429 等暂时性原因失败时,立即且反复地重试只会加重过载,无论对你,还是对共用该服务的所有人都是如此。指数退避会拉开各次尝试的间隔:先等待一个基础延迟,每次失败后将其加倍,直到达到上限;在达到固定尝试次数或截止时间后停止。

实践中有两项改进很重要。其一是抖动,即在每次延迟中加入随机成分,防止许多在同一时刻失败的客户端步调一致地重试,再次把服务压垮。其二是以服务器自身的指示为准:429 响应带有 Retry-After 时,该值优先于计算出的延迟。此外,退避只有与幂等机制结合才有意义,因为重试的发送绝不能变成重复发送。

响应是否重试?
429是,在 Retry-After 指定的时间之后
5xx、超时、网络错误是,采用退避,并使用同一幂等密钥
其他大多数 4xx否;应修正请求

示例

假设一个客户端从一秒开始,每次将延迟加倍并加入完全抖动,总共尝试五次:每两次尝试之间,分别等待最长 1、2、4 和 8 秒的随机时间。短暂的故障只会耽误几秒钟,不会产生重复;长时间的故障最终会让消息暂存在队列中并触发告警,而不是陷入无休止的循环。

常见错误

  • 使用不带抖动的退避,导致所有客户端在相同时刻重试。
  • 重试每次都会以同样方式失败的验证错误。
  • 每次尝试都生成新的幂等密钥。
  • 在库、应用和队列等多个层级叠加重试,使尝试次数成倍增加。

在 SMSMeteor:SDK 页面推荐的重试策略是:429 在等待 Retry-After 指定的秒数后重试;5xx 从一秒开始指数退避,共尝试五次。重试时始终重复使用同一个幂等密钥,绝不要为同一条逻辑消息使用新密钥;除 429 外,不要重试 4xx,而应修正请求。向你的端点投递 Webhook 时,反方向也遵循同样的原则:24 小时内尝试六次(立即一次,然后分别在 +1 分钟、+5 分钟、+30 分钟、+2 小时和 +12 小时),之后事件会被标记为未送达,并可在 30 天内从控制面板重放。请参阅 Webhook 文档。

深入了解

在实践中了解这个术语。一个电子邮箱地址即可开户,费率公开,支持加密货币付款,测试密钥免费。
开始发送