# 面向关键消息的短信API，支持REST或SMPP - 规范 URL: https://www.broadnet.me/zh/products/sms-api - 语言: zh-CN - 最后更新: 2026-10-20 - 发布方: BroadNet (https://www.broadnet.me) - 上述页面的 Markdown 版本，根据渲染后的页面生成。 短信API · REST + SMPP 一条高效的短信API， 节省您的时间。. 通过短信API，您的软件只需通过单个HTTP请求，即可发送一次性密码和警报等短信消息：使用BroadNet时，您的代码通过Bearer令牌调用POST /sms/sendSms，或者通过SMPP进行高吞吐量流水线绑定。已在OpenAPI 3.1规范中记录。官方TypeScript SDK。通过Webhook提供状态报告。可申请测试权限。 [规划您的API集成](https://www.broadnet.me/zh/contact?topic=api-integration&product=sms-api) [申请测试权限（英文表单）](https://www.broadnet.me/zh/contact?intent=test-access) ISO 27001 · 9001 · 22301 GDPR与HIPAA已对齐亚秒级p99 ![BroadNet雪豹面对着一个展开为多个落地通道的单一API通话](https://www.broadnet.me/marketing/generated/viz-sms-api.png) 实时 · 一个API，覆盖所有渠道 消息API 1 API 所有渠道 1,000+ 运营商直连 99.99% SLA API运行时间 99.99% 签署每月SLA，支持多区域 API延迟 <350ms 所有地区的p99目标 官方SDK 1 TypeScript / Node.js + OpenAPI 3.1规范 国家/地区 200+ 1,000+条运营商直连通道 在一次请求内 ## 从您的POST请求到收到状态报告之间发生了什么。 一次TLS握手，五个工程化跳数，两个Webhook。每个阶段都有其专属的延迟预算——且所有预算均受SLA保障，而非仅限于营销页面。 1. 01 · 请求 您的应用 · REST 通过TLS使用POST /sms/sendSms，采用Bearer-token认证，JSON正文包含：senderId, destinationNumber, message, messageType。 p50 < 41ms TTFB 2. 02 · 边缘处理 BroadNet API边缘节点 进行令牌检查、模式验证和路由查找——消息ID将直接在响应中返回。 p50 < 60ms 3. 03 · 路由器 路由+队列 基于每条路由的质量评分选择最快的合法SMPP绑定。多区域双活容灾，切换时间 <800ms。 p50 < 10ms 4. 04 · 绑定 运营商SMPP 3.4 直接将SMPP绑定至目标MNO。submit_sm已发送；序列号用于DLR关联追踪。 p50 < 1.5s 5. 05 · Webhook 状态报告 deliver_sm将作为状态报告被捕获，并根据消息ID通过POST方式发送至您的Webhook URL。 p95 < 2s 6. ← 状态报告 · 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 填写请求，点击发送，即可在此处实时查看模拟响应和送达流程——无需注册。 POST api.broadnet.me/sms/sendSms 请求 `Authorization: Bearer $BROADNET_TOKEN` 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](https://www.broadnet.me/zh/contact?intent=test-access) [完整API参考](https://www.broadnet.me/developers/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参考](https://www.broadnet.me/developers/api#send-sms) 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 推荐 - 基于HTTPS的JSON，TLS 1.3 - Bearer-token认证 — 使用您BroadNet账户的token - POST /sms/sendSms · one path family per channel - 立即发送或定时发送 - 状态报告将推送到您的Webhook - 完整参考请见 /developers/api 速率限制 无固定的单账户限制 最大有效载荷 1 MiB SMPP 3.4 2775普通 · 您的账户将提供TLS端口 高吞吐量 - Binary SMPP v3.4（可根据需求提供v5.0） - 发送端、接收端、收发端绑定 - 每个账户最多支持32个并发绑定 - 通过deliver_sm进行DLR转发 - TLS封装绑定，每个凭据支持IP白名单 - 企业级套餐吞吐量高达每节点每秒30,000条消息 每节点 30k SMS/s 故障转移 <800ms 窗口 100 msg 您实际获得的价值 ## 您无需再自行开发的六项功能。 ### 安全重试 每次成功的发送都会返回一个消息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移动通信 · 中东及北非AE SA 挑战：由于多供应商消息服务架构在重试风暴期间产生重复的OTP验证码——这是一个长期存在的漏洞。方案：迁移至具有单一发送路径的BroadNet REST API，仅在网络错误和5xx错误时进行重试，且每次发送都通过API返回的消息ID进行追踪——通过单个功能标志进行部署。 身份平台首席工程师 Samsung消费科技 · 亚太地区ID 挑战：一家大型消息服务工程团队因版本发布之间未记录的API变更而不断浪费时间。方案：将OpenAPI 3.1规范视为合同，并在每次发布时通过CI重新生成类型化客户端。 消息平台资深工程师 American Express金融服务 · MENA EG 挑战：欺诈团队无法信任无法与发送记录关联的入站送达事件。方案：每份状态报告都会与发送时返回的消息ID进行匹配，发送者ID的轮换也整合在同一流程中。 欺诈与风险工程总监 1:1 DLR ↔ 消息ID Bearer 每次调用均进行Token认证 为生产环境打造 ## 我们书面承诺的数据。 这些目标是企业方案中的合同承诺，而非宣传文案。若未达标，下份账单将自动返还下方的额度。 API运行时间 99.99% 每月SLA REST p99延迟 <350ms 目标覆盖所有地区 Webhook交付 <2s p95端到端 事件响应 <15 min 24/7全天候值班，响应一级严重事件 服务级别承诺 [全方位SLA](https://www.broadnet.me/legal/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 64 API类别，每个通道功能对应一个 在npm上查看](https://www.npmjs.com/package/@broadnet/cpaas-sdk) [broadnet.me/developers/openapi.yaml OpenAPI 3.1规范 329跨八个通道的路径 下载规范文件](https://www.broadnet.me/developers/openapi.yaml) [broadnet.me/developers 文档与快速入门 90s从注册到发送第一条消息 阅读文档](https://www.broadnet.me/zh/developers) TypeScript SDK Bearer-token认证broadnet.me/status ngrok友好型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%的运行时间。 没有您想问的问题？[请咨询我们的工程团队](https://www.broadnet.me/zh/contact) 短信API是进入[更广泛的A2P短信平台](https://www.broadnet.me/zh/products/a2p-sms)。同样的运营商直连通道也为[群发短信活动](https://www.broadnet.me/zh/products/bulk-sms)，[OTP与多渠道验证](https://www.broadnet.me/zh/products/otp)，请[WhatsApp Business API](https://www.broadnet.me/zh/products/whatsapp-business-api)。 正在权衡供应商？请阅读我们的[2026年度最佳短信API](https://www.broadnet.me/zh/compare/best-sms-api-2026)买家指南。 电信级送达率 ## 覆盖覆盖200多个国家/地区，86。 拒绝灰色通道：只要商业上可行，即采用运营商直连，否则采用标记明确的合作伙伴管理通道。通过自 2003 年以来构建的网络，使用同一个 API 连接所有通道。 200+ 国家/地区 1,000+ 运营商连接 300M+ 条/日 [联系销售](https://www.broadnet.me/zh/contact) 测试权限 · 一个工作日内回复 ## 告别与短信服务商的纠缠。开始发送。 一个访问令牌，一个官方TypeScript SDK，以及一个单屏即可完成的快速入门指南。这是从注册到收到首个状态报告的最快路径。 [查看API集成流程](https://www.broadnet.me/zh/contact?topic=api-integration&product=sms-api) [申请开发者入驻](https://www.broadnet.me/onboarding) $ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{"senderId":"BroadNet", …}' 资源 SMS API 数据手册 [下载规格书· PDF, 101 kB](https://www.broadnet.me/resources/datasheets/broadnet-sms-api-datasheet.pdf) [产品数据手册](https://www.broadnet.me/resources) ## 相关指南与问答 深入了解该产品背后的核心概念。 - [什么是短信API 阅读](https://www.broadnet.me/zh/answers/what-is-sms-api) - [如何通过短信API发送短信 阅读](https://www.broadnet.me/zh/answers/how-to-send-sms-via-api) - [什么是SMPP 阅读](https://www.broadnet.me/zh/answers/what-is-smpp) - [什么是A2P短信 阅读](https://www.broadnet.me/zh/answers/what-is-a2p-sms) - [什么是SMSC 阅读](https://www.broadnet.me/zh/answers/what-is-smsc) - [消息服务中的路由自动回退是什么 阅读](https://www.broadnet.me/zh/answers/what-is-route-failover)