Skip to main content
注册
首页/文档中心/开发者中心/国内短信 API

国内短信 API

本页说明国内短信接口，用于提交国内手机号的短信单发或群发请求。调用前请先准备账号、ApiKey 或密码 MD5、短信签名、模板内容和测试手机号，并确保内容使用 UTF-8 URL Encode。

查看快速接入

接口概览

接口请求地址说明
短信发送https://api.smsbao.com/sms提交国内短信单发或群发请求。
上行短信接收客户自定义接收 URL接收用户回复短信，需在后台配置接收地址。
余额查询https://www.smsbao.com/query查询当前账号余额或剩余条数。

短信发送接口

GET https://api.smsbao.com/sms?u=USERNAME&p=PASSWORD_OR_APIKEY&m=PHONE&c=CONTENT&f=FORMAT
参数必填说明
u是短信宝平台注册用户名。
p是平台登录密码 MD5 后的 32 位值，或后台 / 客服提供的 ApiKey。
m是接收手机号；群发时多个手机号用英文逗号分隔，一次不超过 99 个号码。
c是短信内容，需使用 UTF-8 URL Encode。
g否专用通道产品 ID；不填写时使用默认通用短信产品。
f否返回格式。txt 返回明文文本，json 返回 JSON；不填写 f 时，默认返回 txt。

返回结果

返回格式由参数 f 决定：txt 返回明文文本，json 返回 JSON；不填写 f 时，默认返回 txt。

txt

明文文本

返回 0 表示提交成功，其他内容表示错误提示或错误码。

# 成功
0

# 失败（示例：错误密码）
30
返回含义
0提交成功。
其他内容错误提示或错误码。
json

JSON 格式

统一读取 code、msg 和 data 字段。

{
"code": 0,
"msg": "短信发送成功",
"data": {
  "taskId": "202401011200001"
}
}
字段说明
code状态码，0 表示成功，非 0 表示失败。
msg状态描述或错误描述。
data发送成功时包含任务 ID；失败时可能为 null。

上行短信接收

参数必填说明
m是发送方手机号。
c是用户回复的短信内容，使用 UTF-8 URL Encode。
  • 客户需要提供一个可接收 HTTP GET 请求的 URL，并在短信宝后台配置。
  • 处理成功请返回字符串 0；其他返回值会被视为失败。
  • 失败后平台会按间隔重试推送，接口应先接收数据再异步处理，避免阻塞。

余额查询接口

GET https://www.smsbao.com/query?u=USERNAME&p=PASSWORD_OR_APIKEY&f=FORMAT
参数必填说明
u是短信宝平台注册用户名。
p是平台登录密码 MD5 后的 32 位值，或后台 / 客服提供的 ApiKey。
f否返回格式。txt 返回明文文本，json 返回 JSON；不填写 f 时，默认返回 txt。
txt

明文文本

第一行返回 0 表示查询成功；成功时第二行返回发送条数和剩余条数。

# 成功
0
100,998

# 失败（示例：错误密码）
30
json

JSON 格式

按 code 判断成功状态，并从 data.balance 读取剩余可发送条数。

{
"code": 0,
"msg": "查询成功",
"data": {
  "balance": 998
}
}
字段说明
balance剩余可发送条数。
  • 调用频率建议不要超过 1 次 / 分钟。

常见错误码

错误码含义处理建议
30错误密码。检查密码 MD5 值或 ApiKey 是否正确，避免测试账号和正式账号混用。
40账号不存在。确认用户名是否正确，账号是否可正常登录。
41余额不足。检查账户余额、套餐状态或产品余额。
43IP 地址限制。检查接口调用服务器 IP 是否在允许范围内。
50内容含有敏感词。检查短信内容、签名、模板变量和营销合规要求。
51手机号码不正确。检查号码格式、国家区号、分隔符和空格。

完整错误码列表和排查动作请查看 错误码说明。

注意事项

  • 统一使用 UTF-8 编码，短信内容参数需要 URL Encode。
  • 发送前需先完成签名和模板报备，详见 签名报备 FAQ 和 模板报备流程。
  • 测试时请使用正式业务内容，不要给同一手机号连续发送相同内容。
  • 验证码场景建议增加图形验证、频控和业务日志，防止被用于短信轰炸。
  • 请勿发送不合法、要挟、虚假、私人信息、涉黄类内容。