# BroadNet消息API：REST、SMPP与TypeScript SDK

- 规范 URL: https://www.broadnet.me/zh/developers
- 语言: zh-CN
- 最后更新: 2026-10-20
- 发布方: BroadNet (https://www.broadnet.me)
- 上述页面的 Markdown 版本，根据渲染后的页面生成。

开发者中心· v2026.05

专为工程师打造。 先测试，后交付。

BroadNet的消息服务API采用Bearer-token REST API并支持SMPP 3.4，拥有官方TypeScript SDK、OpenAPI 3.1规范以及面向AI智能体的MCP服务器。这个每天处理超过3亿条消息的平台，正是您的 `npm install` 所使用的平台。

[申请测试权限（英文表单）](https://www.broadnet.me/zh/contact?intent=test-access) [阅读快速入门指南](https://www.broadnet.me/zh/developers/quickstart) [API参考](https://www.broadnet.me/developers/api)

申请测试权限我们将在一个工作日内回复SOC 2, ISO 27001

![BroadNet开发者消息服务API的电影级可视化展示](https://www.broadnet.me/marketing/generated/viz-sms-api.png)

BroadNet · 开发者API

api.broadnet.me

REST + SMPP

协议

8

渠道

每日300M+

消息

交互式

## 试用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)

个渠道，一个API

8

短信 · WhatsApp · RCS · Telegram · 电子邮件 · 推送 · Messenger · Instagram

API可用性SLA

99.99%

基于生产环境API端点的合同保障

p99 API延迟

<350ms

从您所在的地区到 /sms/sendSms

OpenAPI规范

3.1

329条路径 · 376项操作 · 可下载

官方SDK

## TypeScript SDK，或任何语言。

一个官方SDK，适用于TypeScript和Node.js。其他所有请求均通过标准HTTPS：直接调用REST API，或根据规范生成客户端。

[TypeScript / Node.js官方SDK，@broadnet/cpaas-sdk：基于BroadNet OpenAPI规范生成，包含完整的类型定义。 `npm install @broadnet/cpaas-sdk axios` 在npm上查看](https://www.npmjs.com/package/@broadnet/cpaas-sdk)

[通过OpenAPI支持任何语言使用任何语言调用REST API，或使用openapi-generator根据OpenAPI 3.1规范生成类型化的客户端。下载openapi.yaml](https://www.broadnet.me/developers/openapi.yaml)

[MCP服务器通过Model Context Protocol使用您的BroadNet令牌将AI智能体连接到BroadNet。设置MCP](https://www.broadnet.me/zh/developers/mcp)

文档

## 你需要的一切，拒绝冗余。

六个入口点，按用例进行分类。每个入口都链接到专门的页面，而非杂乱的200个标签页。

[快速入门 获取令牌，安装TypeScript SDK或使用curl，即可发送您的第一条短信。 打开](https://www.broadnet.me/zh/developers/quickstart)

[API参考 Bearer认证、发送、群发、号码查询、错误信息以及每个渠道的发送端点。 打开](https://www.broadnet.me/developers/api)

[OpenAPI规范 OpenAPI 3.1：涵盖8个通道的329个路径和376个操作。您可以下载或生成客户端。 打开](https://www.broadnet.me/developers/openapi)

[MCP服务器 通过Model Context Protocol将AI智能体连接至BroadNet。 打开](https://www.broadnet.me/zh/developers/mcp)

[SMPP 3.4 针对持续高吞吐量的业务需求，提供SMPP直连绑定。在您申请测试权限时，我们将提供主机地址和端口。 打开](https://www.broadnet.me/developers/smpp)

[Webhook 送达状态将推送到您账户的Webhook URL，并提供用于轮询的端点。 打开](https://www.broadnet.me/developers/webhooks)

[正在从其他短信供应商迁移？ 迁移指南将您当前的发送、状态报告和Webhook调用映射到BroadNet API，并涵盖发送者ID、并行运行、流量爬坡及回退等内容。 阅读迁移指南](https://www.broadnet.me/developers/migrate)

变更内容及时间

按日期列出 OpenAPI 规范、SDK、MCP 服务器、文档和开发者工具的变更。

[阅读变更日志](https://www.broadnet.me/developers/changelog) [Atom订阅源](https://www.broadnet.me/changelog.xml)

常用方案

## 首日即可开展的五项工作。

真实代码，而非伪代码。复制、粘贴、更改收件人，即可发送。

### 发送短信

通过一次HTTPS调用POST /sms/sendSms即可返回消息ID。将messageType设置为TEXT或UNICODE，送达状态将推送到您的Webhook。

[SMS API](https://www.broadnet.me/zh/products/sms-api)

sms.ts

```
// npm install @broadnet/cpaas-sdk axios
import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk";

const sms = new SMSSMSApi(
  new Configuration({
    basePath: "https://api.broadnet.me",
    accessToken: process.env.BROADNET_TOKEN!,
  }),
);

const res = await sms.smsSendsmsPost({
  sMSSmsRequest: {
    senderId: "BroadNet",
    destinationNumber: "447700900123",
    message: "Your verification code is 482913",
    messageType: "TEXT",
  },
});

console.log(res.data); // message ID
```

查看实际效果

## 平台界面展示。

BroadNet消息控制台快速入门——登录、发送及监测。该平台亦由API驱动。

[登录与重置密码登录与重置密码](https://www.youtube.com/watch?v=i851uzE5gMI)

[发送单条消息发送单条消息](https://www.youtube.com/watch?v=TIG0n1C9ecE)

[检查状态报告检查状态报告](https://www.youtube.com/watch?v=op5OjCrAlIQ)

社区与支持

## 真实的工程师，只需简短回复即可联系。

npm上的官方TypeScript SDK。公开的OpenAPI规范和Postman集合。拥有自有通道的支持团队——而非照本宣科的一线客服队列。

[npm 官方TypeScript/Node.js SDK，包含完整的类型定义。可以使用npm和axios进行安装。 npmjs.com/package/@broadnet/cpaas-sdk](https://www.npmjs.com/package/@broadnet/cpaas-sdk)

[Postman 核心调用集合，或导入包含所有操作的OpenAPI规范。 导入集合](https://www.broadnet.me/developers/postman)

[支持 为生产账户提供24/7工程技术支持。P1级响应时间为15分钟。 developers@broadnet.me](mailto:developers@broadnet.me)

从申请到正式上线

## 实现首条消息发送的完整路径，每一步都有明确的时间进度。

1. 01 申请测试权限 我们将在一个工作日内回复 消息工程师会回复并提供您的测试凭据，同时预约一次30分钟的通话，讨论您的目标国家、发送量和使用场景。
2. 02 首条测试短信 获得凭据后约5分钟 使用快速入门代码向您自己的已验证号码发送测试短信。状态报告将返回至您的Webhook。
3. 03 系统集成 2–5个工作日 使用您的测试凭据针对与代码示例相同的端点进行构建和测试。BroadNet工程师将在REST或SMPP上为您提供协作支持。
4. 04 审批 3–10个工作日 在您进行系统集成的同时，我们将并行审核发送者身份、流量用途及目的地规则，并向各监管机构完成发送者ID报备。
5. 05 正式上线 切换日 您的账户已启用生产环境访问权限和通道。您的集成程序已在调用https://api.broadnet.me.

总体而言：大多数市场从申请到生产环境需5–15个工作日；若监管机构的发送者ID报备周期较长，则需更长时间。

买家常见问题

## 开发者问题

请在 /signup申请测试权限，BroadNet工程师将在一个工作日内回复您测试凭据，包括您在Authorization: Bearer请求头中发送的访问令牌，以及测试流量的发送地址。在收到凭据后，大约五分钟内即可发出您的第一条测试短信。

在npm上提供唯一的官方SDK：适用于TypeScript和Node.js的 @broadnet/cpaas-sdk。对于任何其他语言，您可以直接通过HTTPS调用REST API，或者根据OpenAPI规范（/developers/openapi.yaml）生成客户端。

Postman可以根据OpenAPI规范构建集合：导入 /developers/openapi.yaml (OpenAPI 3.1)以获取所有BroadNet端点的集合，然后将您的访问令牌添加为Bearer集合变量。

/status上的状态页面显示网站和公共API的可达性（每5分钟通过合成检测测量）以及事件日志，并可通过 /status/rss.xml的RSS订阅获取更新。生产环境API端点提供99.99%的可用性SLA。

没有您想问的问题？[请咨询我们的工程团队](https://www.broadnet.me/zh/contact)

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

## 申请测试权限。

请将测试短信发送至您自己的已验证号码。在正式上线前，我们会审核发送者身份、流量用途和目的地要求——大多数团队可在5-15个工作日内上线。

[申请测试权限（英文表单）](https://www.broadnet.me/zh/contact?intent=test-access) [联系工程团队](https://www.broadnet.me/zh/contact)

$ npm install @broadnet/cpaas-sdk axios ·几分钟内即可发送首条短信