本页用于整理发送结果相关的开发资料。已公开确认的接口包括国内上行短信接收推送和余额查询；送达状态报告的具体字段和配置方式请以控制台、旧 OpenAPI 或客服开通说明为准。
你可以在这里查看什么
| 内容 | 当前口径 |
|---|
| 发送记录 | 用于排查短信提交、发送状态、失败原因和用户未收到问题。 |
| 上行短信接收 | 公开 OpenAPI 中已说明，可由短信宝向客户配置的 URL 推送用户回复内容。 |
| 余额查询 | 公开 OpenAPI 中已说明，可查询当前账号余额或剩余条数。 |
| 送达状态报告 | 具体回调字段未在当前公开页面中展开，接入时以控制台配置或客服提供说明为准。 |
上行短信接收推送
| 项目 | 说明 |
|---|
| 请求方向 | 短信宝平台 -> 短信宝客户。 |
| 请求方式 | GET。 |
| 接收地址 | 客户提供一个可接收 HTTP GET 请求的 URL，并在短信宝后台配置。 |
| 推送内容 | 一次推送 1 个手机用户回复信息。 |
| 参数 | 必填 | 说明 |
|---|
| m | 是 | 发送方手机号。 |
| c | 是 | 用户回复短信内容，采用 UTF-8 URL Encode。 |
- 客户接口处理成功请返回字符串 0。
- 其他返回值会被认为失败，平台会按间隔重试推送。
- 建议先快速接收数据并入队，再异步处理业务逻辑，避免影响推送速度。
余额查询 API
GET https://www.smsbao.com/query
?u=USERNAME
&p=PASSWORD_OR_APIKEY
| 参数 | 必填 | 说明 |
|---|
| u | 是 | 短信宝平台注册用户名。 |
| p | 是 | 平台登录密码 MD5 后的 32 位值，或后台 / 客服提供的 ApiKey。 |
- 调用频率建议不要超过 1 次 / 分钟。
- 第一行返回 0 视为查询成功；成功时第二行返回发送条数和剩余条数。
发送记录排查方式
| 状态或现象 | 优先检查 | 下一步 |
|---|
| 接口无记录 | 请求地址、参数、账号、密码 / ApiKey、网络日志。 | 回到对应短信 API 页检查请求。 |
| 返回 0 但用户未收到 | 发送记录、手机号、终端拦截、签名模板、状态结果。 | 进入验证码收不到或发送失败排查。 |
| 返回错误码 | 错误码、余额、IP 限制、内容敏感词、手机号格式。 | 按错误码说明处理。 |
| 批量部分失败 | 失败号码、号码格式、内容审核、发送时间。 | 按失败比例和号码来源继续定位。 |
状态报告接入建议
- 如果需要接收送达状态报告，请先在控制台或通过客服确认是否已开通、回调地址如何配置、字段格式是什么。
- 回调接口建议快速返回成功响应，业务处理放入异步队列，避免平台重试或暂停推送。
- 业务侧应保存请求时间、手机号脱敏信息、短信内容摘要、业务订单号、接口返回码和最终状态。
- 不要仅凭接口提交成功判断用户已收到短信，应结合发送记录、状态报告和用户侧反馈。
