短信API · REST + SMPP

面向关键消息的短信API，支持REST或SMPP

一条高效的短信API，节省您的时间。.

通过短信API，您的软件只需通过单个HTTP请求，即可发送一次性密码和警报等短信消息：使用BroadNet时，您的代码通过Bearer令牌调用POST /sms/sendSms，或者通过SMPP进行高吞吐量流水线绑定。已在OpenAPI 3.1规范中记录。官方TypeScript SDK。通过Webhook提供状态报告。可申请测试权限。

规划您的API集成申请测试权限（英文表单）

ISO 27001 · 9001 · 22301GDPR与HIPAA已对齐亚秒级p99

实时 · 一个API，覆盖所有渠道

消息API

1 API

所有渠道

1,000+

运营商直连

99.99%

SLA

API运行时间

99.99%

签署每月SLA，支持多区域

API延迟

<350ms

所有地区的p99目标

官方SDK

TypeScript / Node.js + OpenAPI 3.1规范

国家/地区

200+

1,000+条运营商直连通道

在一次请求内

从您的POST请求到
收到状态报告之间发生了什么。

一次TLS握手，五个工程化跳数，两个Webhook。每个阶段都有其专属的延迟预算——且所有预算均受SLA保障，而非仅限于营销页面。

01 · 请求
您的应用 · REST
通过TLS使用POST /sms/sendSms，采用Bearer-token认证，JSON正文包含：senderId, destinationNumber, message, messageType。
p50 < 41ms TTFB
02 · 边缘处理
BroadNet API边缘节点
进行令牌检查、模式验证和路由查找——消息ID将直接在响应中返回。
p50 < 60ms
03 · 路由器
路由+队列
基于每条路由的质量评分选择最快的合法SMPP绑定。多区域双活容灾，切换时间 <800ms。
p50 < 10ms
04 · 绑定
运营商SMPP 3.4
直接将SMPP绑定至目标MNO。submit_sm已发送；序列号用于DLR关联追踪。
p50 < 1.5s
05 · Webhook
状态报告
deliver_sm将作为状态报告被捕获，并根据消息ID通过POST方式发送至您的Webhook URL。
p95 < 2s
← 状态报告 · Webhook

01 · 请求

您的应用 · REST

通过TLS使用POST /sms/sendSms，采用Bearer-token认证，JSON正文包含：senderId, destinationNumber, message, messageType。

p50 < 41ms TTFB

02 · 边缘处理

BroadNet API边缘节点

进行令牌检查、模式验证和路由查找——消息ID将直接在响应中返回。

p50 < 60ms

03 · 路由器

路由+队列

基于每条路由的质量评分选择最快的合法SMPP绑定。多区域双活容灾，切换时间 <800ms。

p50 < 10ms

04 · 绑定

运营商SMPP 3.4

直接将SMPP绑定至目标MNO。submit_sm已发送；序列号用于DLR关联追踪。

p50 < 1.5s

05 · Webhook

状态报告

deliver_sm将作为状态报告被捕获，并根据消息ID通过POST方式发送至您的Webhook URL。

p95 < 2s

交互式

试用API

填写请求，点击发送，即可在此处实时查看模拟响应和送达流程——无需注册。

POSTapi.broadnet.me/sms/sendSms

请求

访问令牌（Bearer）

Authorization: Bearer $BROADNET_TOKEN

destinationNumber（国家代码，不含+）发送者ID

消息内容编码

request.sh

curl -X POST https://api.broadnet.me/sms/sendSms \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
      "senderId": "BroadNet",
      "destinationNumber": "447700900123",
      "message": "Your verification code is 482913",
      "messageType": "TEXT"
    }'

响应

示例响应 — 未发送任何消息

填写请求并点击“发送测试请求”以查看示例响应。

完全在您的浏览器中运行。不会有任何请求离开此页面，也不会发送任何短信。

Request test access 完整API参考

您的语言

一次调用，九种写法。

每个标签页发送的请求均相同：使用Bearer令牌的POST /sms/sendSms，以及包含senderId、destinationNumber、message和messageType的JSON请求体。响应体为消息ID。

BroadNet拥有一个官方SDK，用于TypeScript和Node.js。Node.js、Python、PHP、Java、C#、Go和Ruby标签页通过常规HTTP库直接调用REST API，无需安装BroadNet包。

完整API参考

POST · api.broadnet.me/sms/sendSms

Example

1curl -X POST https://api.broadnet.me/sms/sendSms \
2  -H "Authorization: Bearer $BROADNET_TOKEN" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "senderId": "BroadNet",
6    "destinationNumber": "447700900123",
7    "message": "Your verification code is 482913",
8    "messageType": "TEXT"
9  }'
10 
11# 200 OK → response body is the message ID, e.g. 2603121407537573731

协议

REST或SMPP—选择您的协议

大多数团队选择REST接口且不再回头。高吞吐量运营商、聚合商以及传统架构则对接SMPP 3.4。相同的通道、相同的SLA、相同的控制面板——请根据业务需求选择合适的接口。

REST · HTTPS

api.broadnet.me/sms/sendSms

您无需再自行开发的六项功能。

安全重试

每次成功的发送都会返回一个消息ID。若遇到网络错误或5xx错误，请使用退避机制进行重试，并根据消息ID与状态报告进行对账，而非盲目重发 —— 后台工作进程可以实现崩溃后的干净恢复。

送达状态Webhook

状态报告将推送到您的Webhook URL并与消息ID绑定，无论是REST还是SMPP流量均适用——无需编写轮询代码。

并发连接数

每个账户支持多达 32 个并行的 SMPP binds。REST 上的 HTTP/2 多路复用。无固定的单账户API速率限制 —— 吞吐量根据您的流量进行调整，单个连接永不设限。

自动故障转移

多区域双活架构。如果通道在活动期间性能下降，我们会在800ms内重新绑定并重新排队正在传输的消息。您无需自行编写SMPP重连逻辑。

无固定速率限制

无固定的单账户API速率限制 —— 吞吐量根据您的流量进行配置，每节点最高30,000条短信/秒。没有静默限流，没有被暗中屏蔽的号码 —— 您始终掌握实时状态。

OpenAPI 3.1规范

机器可读，发布于/developers/openapi.yaml。官方TypeScript SDK即由其生成；您也可以生成任何其他语言的客户端，或将其导入Postman或Insomnia。

客户案例

真正的工程团队
对API的评价。

Uber移动通信 · 中东及北非

挑战：由于多供应商消息服务架构在重试风暴期间产生重复的OTP验证码——这是一个长期存在的漏洞。方案：迁移至具有单一发送路径的BroadNet REST API，仅在网络错误和5xx错误时进行重试，且每次发送都通过API返回的消息ID进行追踪——通过单个功能标志进行部署。

身份平台首席工程师

Samsung消费科技 · 亚太地区

挑战：一家大型消息服务工程团队因版本发布之间未记录的API变更而不断浪费时间。方案：将OpenAPI 3.1规范视为合同，并在每次发布时通过CI重新生成类型化客户端。

消息平台资深工程师

American Express金融服务 · MENA

挑战：欺诈团队无法信任无法与发送记录关联的入站送达事件。方案：每份状态报告都会与发送时返回的消息ID进行匹配，发送者ID的轮换也整合在同一流程中。

欺诈与风险工程总监

1:1

DLR ↔ 消息ID

Bearer

每次调用均进行Token认证

为生产环境打造

我们书面承诺的数据。

这些目标是企业方案中的合同承诺，而非宣传文案。若未达标，下份账单将自动返还下方的额度。

API运行时间

99.99%

每月SLA

REST p99延迟

<350ms

目标覆盖所有地区

Webhook交付

<2s

p95端到端

事件响应

<15 min

24/7全天候值班，响应一级严重事件

服务级别承诺

全方位SLA

每月API运行时间

99.99%

低于99.99%抵扣10% · 低于99.0%抵扣25% · 低于95.0%抵扣50%

REST p50延迟

<100ms

在边缘侧，不包括网络出口

REST p99延迟

<350ms

覆盖所有地区

Webhook交付

<2s p95

失败时支持长达24小时的指数退避机制

SMPP绑定可用性

99.99%

按区域部署，支持跨区域自动回退

事件响应

<15 min

24/7全天候值班，响应一级严重事件

默认提供文档说明

实证。

官方TypeScript SDK是根据OpenAPI 3.1公开规范生成的，因此两者永远保持同步。您可以使用任何其他语言生成客户端，或将规范导入Postman。文档运行的环境与您的代码所使用的预发布环境一致。

npm · @broadnet/cpaas-sdk

官方TypeScript SDK

64API类别，每个通道功能对应一个

在npm上查看

broadnet.me/developers/openapi.yaml

OpenAPI 3.1规范

329跨八个通道的路径

下载规范文件

broadnet.me/developers

文档与快速入门

90s从注册到发送第一条消息

阅读文档

TypeScript SDKBearer-token认证broadnet.me/statusngrok友好型Webhook

买家常见问题

技术问题，
直接解答。

申请测试权限，我们将在一个工作日内回复并提供您的测试凭据；您的第一条测试短信将在之后约五分钟内送达您本人验证过的号码。正式业务流量通常在5–15个工作日内启动，这取决于监管机构对发送者ID报备的审批进度，而非我们的处理进度。

仅在网络错误和5xx错误时进行指数退避重试，并保留API针对每条已接受发送请求返回的消息ID。在重新发送之前，应根据消息ID与状态报告进行核对，而非盲目重试；请在余额不足导致流量受阻前及时充值。

真实可靠。/developers/openapi.yaml（/developers/openapi.json处的JSON）的OpenAPI 3.1规范记录了所有渠道——短信、WhatsApp、RCS、Telegram、Push、电子邮件、Messenger和Instagram。官方TypeScriptSDK(@broadnet/cpaas-sdk)由其生成，您无需向我们咨询即可使用任何其他语言生成自己的客户端。

没有API费用——您只需按消息、按国家、按通道付费。阿联酋交易类短信起价为 $0.0123/MT，沙特为 $0.016，埃及为 $0.028。企业级方案包含SMPP绑定；标准级方案中，每个专用绑定费用为 $250/月。测试权限可按需申请，测试流量上限为每天1,000条消息。

我们会在24小时内进行指数退避重试：30秒、2分钟、10分钟、30分钟、2小时、8小时、24小时。每次重试都会包含一个X-Webhook-Attempt请求头。24小时后，事件将被存入死信队列（DLQ），您可以直接在控制面板中通过一键操作进行查询和重发。标准版保留DLQ 7天；企业版保留90天。

是的 —— 它们共享路由、DLR、计费和仪表板。大多数客户在同一个账户中使用REST处理交易类消息，并使用SMPP进行大批量营销，且两种通道的状态报告都会汇总到相同的报告和Webhook中。

配备专属技术客户经理，提供99.99%的API可用性SLA，并针对月费提供服务抵扣（低于99.99%时抵扣10%，低于99.0%时抵扣25%，低于95.0%时抵扣50%）；24/7 NOC呼叫器支持 <15分钟的1级故障响应；提供专属SMPP绑定、季度架构审查，以及与工程团队共享的Slack频道。

broadnet.me/status显示组件状态及已发布的故障信息。该页面尚未接入实时监控，因此其90天历史记录仅供参考，并非实际测量值；合同约定的服务等级协议（SLA）为99.99%的运行时间。

没有您想问的问题？请咨询我们的工程团队

短信API是进入更广泛的A2P短信平台。同样的运营商直连通道也为群发短信活动，OTP与多渠道验证，请WhatsApp Business API。

正在权衡供应商？请阅读我们的2026年度最佳短信API买家指南。

电信级送达率

覆盖覆盖200多个国家/地区，86。

拒绝灰色通道：只要商业上可行，即采用运营商直连，否则采用标记明确的合作伙伴管理通道。通过自 2003 年以来构建的网络，使用同一个 API 连接所有通道。

200+

国家/地区

1,000+

运营商连接

300M+

条/日

联系销售

测试权限 · 一个工作日内回复

告别与短信服务商的纠缠。
开始发送。

一个访问令牌，一个官方TypeScript SDK，以及一个单屏即可完成的快速入门指南。这是从注册到收到首个状态报告的最快路径。

查看API集成流程申请开发者入驻

$ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{"senderId":"BroadNet", …}'

资源

SMS API 数据手册

下载规格书· PDF, 101 kB 产品数据手册

面向关键消息的短信API，支持REST或SMPP

从您的POST请求到
收到状态报告之间发生了什么。

试用API

一次调用，九种写法。

REST或SMPP—选择您的协议

您无需再自行开发的六项功能。