两者分别是什么
SMPP(短消息点对点协议,Short Message Peer-to-Peer)是在持久 TCP 会话上运行的二进制协议。客户端(规范中称为 ESME)以发送端(transmitter)、接收端(receiver)或收发端(transceiver)身份绑定到服务器,以协议数据单元(submit_sm)提交消息,并通过绑定连接接收送达回执和入站消息(deliver_sm)。保活消息(enquire_link)使会话保持打开。大多数部署使用的是 3.4 版。它是为运营商和聚合商每秒交换数千条消息而设计的,至今仍是它们之间的批发协议。
HTTP API 将相同的操作映射为 Web 请求:POST 创建消息,GET 读取其状态,Webhook 推送送达回执。每个请求都是独立的,携带自己的密钥并通过 HTTPS 传输,因此任何语言、任何服务器和任何无服务器函数都可以使用。SMPP 术语表条目收录了相关词汇。
逐项比较
| 方面 | SMPP | HTTP API |
|---|---|---|
| 连接 | 长期绑定、保活、窗口管理、重连逻辑 | 无状态 HTTPS 请求;任何客户端都可使用 |
| 认证 | 绑定时使用 system id 和密码,双方通常还会配置 IP 允许名单 | 每个请求都携带 Bearer 密钥,可选择限制为 IP 允许名单 |
| 编码 | 由你设置数据编码、拆分长文本并构造拼接标头 | 平台检测编码、拆分文本,并返回分段数和价格 |
| 回执 | 作为接收端或收发端绑定上的消息返回,文本格式因提供商而异 | 携带你自定义引用的签名 Webhook 事件 |
| 重试 | 没有幂等机制:响应丢失后只能靠猜 | 幂等密钥会返回原始结果 |
| 流量控制 | 窗口大小,以及提供商返回的限流错误 | 速率限制标头,以及 429 时的 Retry-After |
| 运维 | 由你运行、监控、故障转移并配置允许名单的绑定连接 | 可从任何地方调用,包括无服务器函数 |
分段计算在两边都一样:消息拆分后,每部分可容纳 153 个 GSM-7 字符或 67 个 Unicode 字符。区别在于由谁来做;编码指南解释了这些长度。
吞吐量计算
在 SMPP 上,一个绑定的上限大致等于窗口大小除以往返时间,同时受提供商所授予速率的限制。假设窗口为 10、往返时间为 50 毫秒:10 ÷ 0.05 = 每秒最多 200 个 PDU。使用拼接标头发送的三段消息就是三个 submit_sm PDU,因此同一个绑定每秒约能承载 67 条三段消息。吞吐量越高,需要的绑定就越多,而每个绑定都是一条需要保持健康的连接。
在 HTTP 上,计算更简单。速率限制为每个密钥每秒 50 个请求,而一个最多包含 1,000 条消息的批量请求只算一个请求:
- 单条请求:每秒 50 条消息,即每小时 50 × 3,600 = 180,000 条;
- 批量请求:每个密钥的提交上限为每秒 50 × 1,000 = 50,000 条消息;
- 300,000 条提醒:300 个批量请求,以满速发送需要 6 秒(300 ÷ 50),以每秒 5 个请求的宽松速度发送则需要一分钟。
延迟决定的是所需的并发量,而不是上限。往返时间为 200 毫秒时,逐个等待响应的客户端每秒只能发出 5 个请求;要达到 50 个,需要约 10 个并发请求(50 × 0.2)。两种协议都只管提交:消息到达手机的速度取决于目的地网络,与把消息送到提供商的是哪种协议无关。
送达回执
在 SMPP 上,你需要在每次提交的 registered_delivery 字段中请求回执,回执会作为 deliver_sm 在接收端或收发端绑定上返回。其文本通常遵循 3.4 规范附录中的示例格式:
id:IIIIIIIIII sub:001 dlvrd:001 submit date:YYMMDDhhmm done date:YYMMDDhhmm stat:DELIVRD err:000这个格式只是示例,并非规则,各提供商的实现也不尽相同:消息 ID 在提交响应中可能是十六进制,在回执中却是十进制;err 的取值因网络而异;在接收端绑定断开期间到达的回执,会按提供商自己的策略排队、重试或丢弃。将回执与消息匹配的代码,需要你自己编写和维护。
在 HTTP 上,回执是签名的 Webhook 事件,即 message.sent、message.delivered 或 message.failed,携带你为消息设置的 reference;失败事件还附带易懂的原因和原始运营商代码。你的端点错过的事件会在 24 小时内重试 6 次,并可在 30 天内从控制面板重放;生产环境中的 Webhook 介绍了处理程序。两种协议都无法改善网络返回的内容:大多数目的地返回手机回执,少数只返回运营商确认,在这些目的地,已发送就是最终的成功状态。
重试与重复
SMPP 没有幂等机制。如果 submit_sm 超时,或者绑定在窗口中仍有 PDU 时断开,你就无法判断消息是否已被接受:重新提交可能造成重复,不重新提交则可能造成丢失。查询也解决不了问题,因为 query_sm 需要消息 ID,而这个 ID 本应由丢失的响应带回。ESME_RTHROTTLED 之类的限流错误反而是简单的情况:消息已被拒绝,所以退避后再次提交即可。
在 HTTP 上,发送由你自己的记录派生的 Idempotency-Key,并在每次重试时重复使用。使用相同幂等密钥的重试会返回原始结果,而不会再次发送,因此一次超时的代价是多一个请求,而绝不会是多一条消息。
import time, requests
def send(base_url, api_key, message, idem_key):
headers = {"Authorization": "Bearer " + api_key, "Idempotency-Key": idem_key}
for attempt in range(5):
try:
r = requests.post(base_url + "/v1/messages", json=message,
headers=headers, timeout=10)
except requests.RequestException:
time.sleep(2 ** attempt) # 网络错误:使用相同的键再试一次
continue
if r.status_code == 429:
time.sleep(float(r.headers.get("Retry-After", "1")))
continue
if r.status_code >= 500:
time.sleep(2 ** attempt)
continue
return r # 2xx,或需要修正而非重试的 4xx
raise RuntimeError("unconfirmed: retry later with the same idem_key")批量请求多一条规则。格式错误的批次会被整体拒绝;但如果批次中只有少数条目有问题,有效条目会进入队列,其余条目则连同错误作为已拒绝返回:只修正并重新发送被拒绝的条目,放进一个新请求,并使用新的幂等密钥。
何时值得使用 SMPP
当你本身就是聚合商,或者是向使用 SMPP 的合作伙伴转售流量的平台时;当你全天候持续每秒发送数百条消息,并且有提供商授予与之匹配的绑定时;或者当现有系统只支持 SMPP、且无法替换时。对于发送验证码、通知和群发任务的应用程序,它只会增加成本和故障模式,却不会改善送达。有三种观念让它出现在本不该出现的需求文档中:
- “SMPP 送达效果更好。”送达取决于从提供商到运营商的路由;你与提供商之间使用什么协议并不会改变它。
- “SMPP 更快。”两种协议增加的都只是毫秒级的延迟;消息在运营商网络中停留的时间通常要长得多。
- “SMPP 更便宜。”在同时提供两种协议的提供商那里,每条消息的价格通常取决于目的地,而不是协议。SMPP 增加的是运行绑定连接的成本,而这部分成本由你承担。
用 HTTP 实现高流量
HTTP 的高流量来自批处理,而不是并行发送单条请求。一个批量请求最多承载 1,000 条消息,并返回逐条结果;以每秒 50 个请求计算,这远超绝大多数发送者可能需要的量。几个习惯能让发送保持顺畅:
- 读取
X-RateLimit-Remaining,在触发 429 之前放慢速度;收到 429 时,等待Retry-After指定的时间。 - 让平台保管消息:用
send_at指定固定时刻,用当地window实现按当地时间送达,以此取代你这一端的定时器。 - 通过 Webhook 接收结果,而不是轮询;逐条轮询 300,000 条消息,就是 300,000 个本不需要的请求。
- 每个发送系统使用自己的密钥,因为限制按密钥计算。
如果确实需要 SMPP
签约前先向提供商确认:
- 使用哪个版本?会话是否受 TLS 或 VPN 保护?未加密的 SMPP 会以明文发送密码。
- 提供多少个绑定、哪些类型,每个绑定的吞吐量是多少,窗口大小是多少?
- 在他们那边,
data_coding0 代表什么:GSM-7、Latin-1 还是其他编码? - 长消息应如何传输:拼接标头、SAR 参数,还是
message_payload? - 回执格式是什么?消息 ID 是十六进制还是十进制?错误代码如何映射?
- 接收端绑定断开期间,回执会如何处理,会保留多久?
- 他们期望的
enquire_link间隔和空闲超时是多少?
SMSMeteor 提供什么
REST API,提供 Bearer 密钥(sk_live_ 和 sk_test_)、发送和读取权限,以及每个密钥可选的 IP 允许名单;支持单条消息和最多 1,000 条的批量请求;幂等密钥;使用 send_at 定时发送、当地时间段,以及批量请求的限速;带重试和重放的签名 Webhook;一份 OpenAPI 描述;以及 cURL、Python、Node、PHP 和 Go 的 SDK 示例。测试密钥会像正式密钥一样验证、计价和响应,但不会发送或计费。我们不向账户提供 SMPP。如果你的系统只支持 SMPP,就需要一家提供绑定连接的提供商,最好在集成之前就弄清楚这一点。
有内容不清楚或已经过时?请在支持页面告诉我们;修正内容会更新到指南中,同时更新修订日期。
