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

开发者中级阅读约 7 分钟更新于 2026年10月18日

SMPP 与 HTTP API:你真正需要哪一个?

SMPP 还是 HTTP SMS API?比较协议差异、吞吐量计算、送达回执和重试,并说明少数值得运行绑定连接的情况。

两者分别是什么

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 术语表条目收录了相关词汇。

逐项比较

方面SMPPHTTP 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 规范附录中的示例格式:

SMPP
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,并在每次重试时重复使用。使用相同幂等密钥的重试会返回原始结果,而不会再次发送,因此一次超时的代价是多一个请求,而绝不会是多一条消息。

Python
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_coding 0 代表什么: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,就需要一家提供绑定连接的提供商,最好在集成之前就弄清楚这一点。

立即付诸实践。一个电子邮箱地址即可开户。费率公开,支持加密货币付款,测试密钥免费。
开始发送

有内容不清楚或已经过时?请在支持页面告诉我们;修正内容会更新到指南中,同时更新修订日期。