# 获取凭证后，只需五分钟即可发送您的首条测试短信。

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

开发者快速入门

申请测试权限，我们将在一个工作日内回复并提供您的测试凭据。随后，获取令牌，安装TypeScript SDK并进行调用 `smsSendsmsPost` 。在您获得凭据后，约五分钟内，您的第一条测试消息就会送达您自己的已验证号码。下方的每个示例均可直接复制，第5步涵盖了上线前需要检查的事项。

[申请测试权限（英文表单）](https://www.broadnet.me/zh/contact?intent=test-access) [完整API参考](https://www.broadnet.me/developers/api)

进度

0 / 5 步骤 · 5分钟

0/5

剩余步骤

5

1. 获取您的访问令牌。 第1步 ·30秒
2. 安装SDK。 第2步 ·45秒
3. 发送您的第一条消息。 第3步 ·60秒
4. 接收送达状态。 第4步 ·90秒
5. 生产环境上线前。 第5步 ·不包含在五分钟内

从申请到正式上线

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

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报备周期较长，则需更长时间。

流程图A2P消息如何送达手机

1. 您的应用程序通过REST API或SMPP发送
2. BroadNet平台验证、路由并结算每条消息
3. 运营商的SMSC运营商直连
4. 用户手机消息已送达

状态报告(DLR)沿相同路径返回至您的Webhook

本页内容

1. 01获取您的访问令牌。
2. 02安装SDK。
3. 03发送您的第一条消息。
4. 04接收送达状态。
5. 05生产环境上线前。

凭据获取后

5分钟

从获取测试凭据到发送第一条测试短信仅需约五分钟。Webhook 步骤需要一个公网 URL；使用 ngrok 即可。

01

第1步· 30 秒

## 获取您的访问令牌。

您的访问令牌随测试凭据一同提供：申请测试权限，我们将在一个工作日内回复。请将其存储在 BROADNET_TOKEN 环境变量中，并在每次调用时通过 Authorization: Bearer 请求头发送。本页面上的所有示例均使用生产环境基础 URL https://api.broadnet.me。

您的BroadNet账户·访问令牌

访问令牌

quickstart-default

active

84f1a02e3c7d4b91a7e0•••••••••••• copy

报头

Bearer

环境变量

BROADNET_TOKEN

基础URL

api.broadnet.me

$ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" …

200 OK

进行测试

使用 POST /sms/sendSms 向您自己已验证的号码发送一条测试短信。如果返回 200 OK 且响应体为消息 ID，则说明在您编写其他代码之前，令牌已生效。

step 1.broadnet.me

02

第2步· 45 秒

## 安装SDK。

BroadNet有一个官方SDK，适用于TypeScript和Node.js：npm install @broadnet/cpaas-sdk axios。它是根据BroadNet OpenAPI规范生成的。在任何其他语言中，请使用您常用的HTTP库调用REST API，或者根据OpenAPI规范生成客户端。

安装

```
npm install @broadnet/cpaas-sdk axios

export BROADNET_TOKEN=your_access_token
```

bash

node >= 18

进行测试

从@broadnet/cpaas-sdk导入Configuration和SMSSMSApi。如果导入成功且类型检查通过，您即可开始发送。

step 2.broadnet.me

03

第3步· 60 秒

## 发送您的第一条消息。

使用您的基础URL和令牌创建一个SMSSMSApi，调用smsSendsmsPost并传入senderId、destinationNumber、message和messageType，然后记录结果。响应体即为消息ID；请保留该ID以便稍后匹配送达状态。

POST /sms/sendSms

```
// 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
```

javascript

200 OK · 消息ID

响应 · 200 OK

正文 · 消息ID

```
HTTP/1.1 200 OK

2603121407537573731
```

进行测试

检查您手中的手机。如果您收到了短信，那么最难的部分已经完成了——以下内容仅为操作层面的优化。

step 3.broadnet.me

04

第4步· 90 秒

## 接收送达状态。

BroadNet会将送达状态推送到您账户配置的Webhook URL：在支持已读回执的渠道上显示SUBMITTED、SENT、DELIVERED、READ，或显示FAILED和REJECTED。请存储每次更新，快速回复2xx，并进行异步处理。

POST /webhooks/broadnet

```
import express from "express";

const app = express();

app.post("/webhooks/broadnet", express.json(), async (req, res) => {
  // Store the status update first, then acknowledge with a 2xx.
  // Statuses: SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED.
  await db.statusUpdates.insert({ receivedAt: new Date(), body: req.body });
  res.sendStatus(200);
});
```

javascript

送达状态 · JSON

DELIVERED

已在手机端确认。在消息通过网络传输时，会先收到SUBMITTED和SENT等早期更新。

送达后

READ

收件人已阅读，适用于WhatsApp等支持已读回执的渠道。

已读

失败 / 被拒

未送达。再次发送前，请检查号码格式和您的发送者ID。

最终状态

进行测试

向您的手机发送一条消息，然后检查服务器日志以查看DELIVERED状态更新。

step 4.broadnet.me

05

第5步·不包含在五分钟内

## 生产环境上线前。

审批完成后即可开启生产环境：包括发送者身份、流量用途和发送者ID报备，审批过程需 3–10 个工作日，可与您的集成工作同步进行。审批通过后，相同的代码即可发送生产流量。在此之前，请务必不要将令牌提交至源代码控制系统，并配置好状态报告 Webhook 以及确定您的重试策略。

- 01 将密钥移至您的环境 请将BROADNET_TOKEN保存在环境变量或您的密钥管理器中，切勿将其存放在源代码控制或客户端代码中。一旦发生泄露，请立即更换。
- 02 安全重试并实时监控余额 针对网络错误和5xx响应，请使用指数退避机制进行重试。每次接受的发送都会返回一个消息ID，因此请存储该ID并检查送达状态，而不是盲目重发。群发短信会在每次响应中报告您的剩余额度。
- 03 固定SDK版本 请在package.json中将 @broadnet/cpaas-sdk固定为确切版本，并进行谨慎升级。API路径不带版本前缀，请密切关注变更日志和OpenAPI规范中的变化。
- 04 通过状态码处理错误 错误将返回HTTP状态码以及包含status、error、message、errorCode和requestUri的ExceptionResponse主体。请修复400和401错误；针对5xx错误请使用退避机制进行重试。
- 05 制定您的重试策略 默认设置：针对5xx和网络错误执行指数退避算法，绝不对4xx错误执行。超时后，请在重新发送前检查状态报告，因为第一个请求可能已被接受。

进行测试

请根据您的代码运行以下检查清单。当所有选项都勾选完成后，只要审批通过，您的集成即可进入生产环境。

step 5.broadnet.me

从第一天起即为生产环境而设计

## 相同的代码路径每天处理超过3亿条消息。

您的测试流量并非模拟。您在上述步骤中配置的每一个请求、密钥和Webhook，都将通过与我们企业级流量相同的通道、计费和合规架构进行处理——且该架构每年都会根据以下认证进行审计。

ISO 27001

信息安全

ISO 9001

质量管理

ISO 22301

业务连续性

GDPR

符合标准 · 欧盟数据驻留

HIPAA

符合标准 · 可根据要求提供BAA

SOC 2

Type II · 年度审计

欧盟+阿联酋数据驻留99.99% API可用性SLA测试与生产环境共用一个基础URL送达状态Webhook

买家常见问题

## 快速入门问题

发送带有Authorization: Bearer请求头且包含senderId、destinationNumber、message和messageType（TEXT或UNICODE） JSON主体的POST https://api.broadnet.me/sms/sendSms请求。响应内容为消息ID。位于 /websmpp下的旧版HTTP API仍可用于SMPP时期的集成。

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

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

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

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

## 已完成五步。一键启动。

先针对您自己的已验证号码进行测试，完成集成部署，然后通过同一个控制台切换至生产流量。使用相同的SDK、相同的端点，以及每天承载超过3亿条消息的相同SLA。

[申请测试权限（英文表单）](https://www.broadnet.me/zh/contact?intent=test-access) [完整API参考](https://www.broadnet.me/developers/api)

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