v1接口 v1
本页说明国内短信接口 v1，用于提交国内手机号的短信单发或群发请求。调用前请先准备账号、ApiKey 或密码 MD5、短信签名、模板内容和测试手机号，并确保内容使用 UTF-8 URL Encode。
短信发送接口
GET https://api.smsbao.com/sms
?u=USERNAME
&p=PASSWORD_OR_APIKEY
&g=GOODSID
&m=PHONE
&c=CONTENT
| 参数 | 必填 | 说明 |
|---|
| u | 是 | 短信宝平台注册用户名。 |
| p | 是 | 平台登录密码 MD5 后的 32 位值，或后台 / 客服提供的 ApiKey。 |
| g | 否 | 专用通道产品 ID；不填时使用默认通用短信产品。 |
| m | 是 | 接收手机号；群发时多个手机号用英文逗号分隔，一次不超过 99 个号码。 |
| c | 是 | 短信内容，需使用 UTF-8 URL Encode。 |
返回结果
| 返回 | 含义 | 处理方式 |
|---|
| 0 | 提交成功。 | 继续查看发送记录或状态结果，不要直接等同于用户一定收到。 |
| 其他内容 | 错误提示或错误码。 | 对照错误码说明、请求参数、余额、签名模板和内容审核继续排查。 |
常见错误码
| 错误码 | 含义 | 处理建议 |
|---|
| 30 | 错误密码。 | 检查密码 MD5 值或 ApiKey 是否正确，避免测试账号和正式账号混用。 |
| 40 | 账号不存在。 | 确认用户名是否正确，账号是否可正常登录。 |
| 41 | 余额不足。 | 检查账户余额、套餐状态或产品余额。 |
| 43 | IP 地址限制。 | 检查接口调用服务器 IP 是否在允许范围内。 |
| 50 | 内容含有敏感词。 | 检查短信内容、签名、模板变量和营销合规要求。 |
| 51 | 手机号码不正确。 | 检查号码格式、国家区号、分隔符和空格。 |
上行短信接收
| 参数 | 必填 | 说明 |
|---|
| m | 是 | 发送方手机号。 |
| c | 是 | 用户回复的短信内容，使用 UTF-8 URL Encode。 |
- 客户需要提供一个可接收 HTTP GET 请求的 URL，并在短信宝后台配置。
- 处理成功请返回字符串 0；其他返回值会被视为失败。
- 失败后平台会按间隔重试推送，接口应先接收数据再异步处理，避免阻塞。
余额查询接口
GET https://www.smsbao.com/query
?u=USERNAME
&p=PASSWORD_OR_APIKEY
| 参数 | 必填 | 说明 |
|---|
| u | 是 | 短信宝平台注册用户名。 |
| p | 是 | 平台登录密码 MD5 后的 32 位值，或后台 / 客服提供的 ApiKey。 |
- 调用频率建议不要超过 1 次 / 分钟。
- 第一行返回 0 视为查询成功；成功时第二行返回发送条数和剩余条数。
注意事项
- 统一使用 UTF-8 编码，短信内容参数需要 URL Encode。
- 测试时请使用正式业务内容，不要给同一手机号连续发送相同内容。
- 验证码场景建议增加图形验证、频控和业务日志，防止被用于短信轰炸。
- 请勿发送不合法、要挟、虚假、私人信息、涉黄类内容。
