短信宝开发者中心

围绕短信 API 接入、测试发送、签名模板报备、错误码和发送记录，整理开发者需要的接入资料

接入路径

为您提供的开发者资源

从 API 文档到代码示例，从插件到测试工具，整理接入前后需要查看的资料入口

HTTP/HTTPS API

API 直接接入

通过 HTTP/HTTPS API 接口调用，按文档查看请求参数、响应字段和鉴权方式。

查看详情 →
建站插件

插件快速接入

提供 WordPress、Discuz、Typecho 等常见建站系统插件，适合希望降低开发工作量的接入场景。

查看详情 →
Web 控制台

控制台在线测试

登录控制台可发送测试短信，用于验证账号、签名模板和接口配置是否准备就绪。

查看详情 →
代码示例

多语言 Demo

提供 PHP、Java、Python、Node.js、Go 等语言的调用示例，便于按业务环境改造测试。

查看详情 →
快速接入

按六步完成基础接入准备

从注册、测试、报备到排查，梳理上线前需要确认的步骤

01

注册账号

访问短信宝官网完成注册，在控制台查看接口信息和账户配置。

免费注册 →
02

查看 API 文档

阅读完整的 API 接口文档，了解请求参数、响应格式和认证方式。

查看文档 →
03

发送测试短信

使用控制台或 cURL 命令发送一条测试短信，验证接口连通性。

在线测试 →
04

准备签名和模板

根据业务需求准备短信签名和内容模板，提交报备审核。

报备指南 →
05

查看发送记录

在控制台查看发送记录、状态回执和消费明细，判断提交、回执和计费状态。

发送记录 →
06

上线前排查错误码

熟悉常见错误码含义和处理建议，提前准备异常处理和客服排查路径。

错误码说明 →
quickstart.txt
# 步骤 1：注册或登录账号
打开 /reg 完成注册
登录控制台，确认账号状态、余额和 API 信息
步骤 1 / 6
API 文档

API 文档入口

选择对应的 API 接口查看详细文档，包含请求参数、响应示例和错误码说明

国内短信 API

验证码短信、通知短信、营销短信的统一发送接口，支持批量发送和定时发送。

发送接口批量发送定时发送

国际短信 API

面向国际短信发送场景，结合目的地、通道规则和发送状态查看接入说明。

国家码格式通道规则发送状态

语音验证码 API

语音电话播报验证码，适用于短信未及时收到、关键校验需要补充触达的场景。

语音播报双因素认证防刷

状态报告 / 发送记录

查看短信发送状态回执、历史发送记录和消费明细，辅助定位发送结果。

状态回执发送记录消费明细

错误码说明

整理 API 返回码、可能原因和处理建议，辅助定位接口调用异常。

返回码排查指南常见问题
上述为 API 文档入口，完整参数表请点击对应卡片查看详细文档页面。
代码示例

多语言代码示例

这里展示最小调用示例，完整 PHP、Java、Node.js、Python、Go、ASP、C# 示例请查看代码示例文档。

example.sh
# cURL 连通性测试示例
curl -G "https://api.smsbao.com/sms" \
  --data-urlencode "u=$SMSBAO_USER" \
  --data-urlencode "p=$SMSBAO_API_KEY" \
  --data-urlencode "m=13800138000" \
  --data-urlencode "c=【短信宝】您的验证码是 123456"
接口参数以实际文档为准。请勿在生产环境硬编码 API Key，建议使用环境变量存储密钥。查看完整代码示例文档
插件中心

不会深度开发也能接入

提供主流建站系统和 CMS 的插件入口，适合用插件降低短信验证码、通知和会员验证的接入成本

WordPress 插件

适用于用户注册、登录、找回密码等场景的短信验证码功能，具体安装步骤以插件说明为准。

查看详情 →

Discuz 插件

论坛注册、发帖验证、密码找回等场景短信接入，支持 Discuz! X3.x 版本。

查看详情 →

Typecho 插件

博客评论通知、用户注册验证等场景的短信接入入口，适合轻量站点按需配置。

查看详情 →

通用验证码插件

适用于任何网站的用户注册、登录、表单提交的短信验证码接入方案。

查看详情 →

商城 / CMS 插件

支持主流电商系统和 CMS 的订单通知、物流提醒、会员验证等功能。

查看详情 →

插件常见问题

插件安装、配置、排错等常见问题的解答和解决方案。

查看详情 →
报备与合规

技术接入与合规连接

开发者页必须把技术接入和合规连接起来。签名和模板报备是短信发送的前置条件，提前了解报备流程，避免上线阻塞。

签名报备 FAQ

了解签名报备的要求、规范和常见问题，降低材料补交和审核驳回概率。

模板报备流程

从模板编写到审核通过的完整流程指南，包含常见被驳回原因分析。

报备材料清单

查看企业用户常见报备材料，提前准备可减少补交。

发送前检查清单

正式发送前检查签名、模板、余额、接口、发送记录和异常处理路径。
错误码与排查

错误码与排查指南

常见返回码、发送失败原因、状态报告解读和验证码问题排查

返回码 含义 处理重点
0提交成功，平台已接收请求查记录
30密码、MD5 或 ApiKey 错误鉴权
40账号不存在或账号环境不一致账号
41账户余额或产品余量不足余额
43调用服务器 IP 不在允许范围内IP
50 / 51内容敏感或手机号码格式不正确内容/号码
问题阶段 怎么判断 下一步
接口未提交API 返回错误码或控制台没有发送记录查参数
提交后失败发送记录显示失败，或状态报告返回失败原因查记录
成功未收到记录显示成功，但用户手机没有收到短信查终端
部分失败同一批次部分号码失败或延迟查号码
内容审核签名、模板、变量或敏感词导致失败查报备
余额费用余额、套餐或产品 ID 不匹配查余额
记录状态 说明 处理重点
无记录请求未被平台接收，通常是接口、账号或网络问题回查请求
提交成功返回 0 只代表提交成功，不等于用户已收到看回执
发送失败根据发送记录或状态报告中的失败原因继续定位看原因
状态未知可能仍在回执中，或需结合后台记录确认稍后查
上行/回调上行短信和状态报告回调需先确认控制台或客服配置查配置
批量记录记录失败号码比例、发送时间、内容和号码来源分批查
现象 优先检查 处理重点
验证码收不到先看接口返回码，再看发送记录和状态报告按记录查
提交成功未收到确认号码状态、手机拦截、发送时间和运营商延迟查终端
频繁发送检查同手机号、同 IP、同设备的请求频率加风控
内容被拦截确认签名、模板变量和验证码文案是否合规查模板
扣费疑问以平台资费、发送记录和最终状态规则为准查计费
复现困难保留请求时间、脱敏手机号、返回码和业务场景留现场
查看完整错误码文档 → 短信发送排查指南 →
产品入口

产品接入入口

按短信使用场景进入对应产品页，再查看 API、价格、报备规则和常见问题。

重点推荐

验证码短信接入

用于注册登录、找回密码、支付确认等场景，可从产品页继续查看接口、校验、防刷和安全策略。

验证码发送 API验证码校验逻辑防刷策略安全建议

通知短信接入

订单通知、物流提醒、账户变动等系统消息触达场景。

通知模板设计变量替换批量通知

营销短信接入

短信群发、会员营销、活动推广等场景，重点查看模板审核、退订和发送记录要求。

群发接口会员分组退订处理

国际短信接入

面向海外号码触达，进入产品页查看国家码格式、费率入口、通道规则和注意事项。

国家码格式通道规则费率说明

语音验证码接入

语音电话播报验证码，适用于短信未及时收到或关键校验需要补充触达的场景。

语音 API播报模板双因素认证
常见问题

开发者 FAQ

围绕接口、测试、报备、发送记录和插件接入整理常见问题

短信 API 面向开发者，通过编程方式集成到您的应用中，适合批量发送、自动化场景；控制台发送是网页界面操作，适合测试、少量发送或运营人员使用。两者共用同一账户余额和发送通道。
测试短信用于验证账号、接口、签名模板和通道配置。不同账户或场景可能存在测试数量、模板和审核要求，建议先完成小范围测试，再进入正式发送流程。
首先查看接口返回的状态码和发送记录，确认是否被运营商拦截。然后检查：1）手机号格式是否正确；2）签名和模板是否已报备通过；3）用户手机是否有拦截软件；4）查看状态报告获取详细失败原因。可联系技术支持协助排查。
通常需要使用已报备并通过审核的签名和模板。未通过报备时，发送可能被系统或运营商拦截，并返回签名、模板相关错误码。建议提前准备材料并预留审核时间。
您可以在开发者中心的"错误码说明"页面查看完整的错误码对照表，包含返回码、说明和处理建议。也可以在发送记录页面点击单条记录查看详细的错误信息。
支持。短信宝提供 WordPress、Discuz、Typecho 等常见建站系统插件，也提供通用验证码插件。插件适合用户注册、登录、找回密码等常见场景，具体配置步骤以插件说明和当前系统版本为准。
注册