定义
短信 API 是一种 Web 接口,通常是基于 HTTPS 的 REST 加 JSON,让软件无需直接管理电信连接,就能以编程方式发送短信、接收回复并获取送达状态。
典型调用是把 E.164 格式的收件人、Sender ID 和文本,连同 API 令牌 POST 到某个端点,并获得一个消息 ID。送达状态和上行回复之后通过 webhook 到达。
与 SMPP 相比,HTTP API 更易集成,可穿过标准防火墙,也适合无服务器和 Web 应用。在持续的超大发送量下,SMPP 更高效。
最佳实践:令牌只保存在服务端;让发送具备幂等性,避免重试造成重复发送;处理 429 速率限制响应;并校验 webhook 请求。
api.broadnet.me 上的 OmniChannels.ai REST API 采用 Bearer 令牌认证,除短信外还覆盖 WhatsApp、RCS 和其他渠道。
示例
POST /sms {"to":"+971501234567","from":"AcmeBank","text":"您的验证码是 482913"}