首页 / 短信服务
短信验证码 / 通知短信

短信验证码 API
一个接口,把验证码发到用户手机上

面向 App / 小程序 / 网站的验证码与通知短信下发能力。模板自动报备、签名由平台统一维护, 注册后生成 API Key 即可调用,按条计费、明码标价,额度即时到账。

1 个接口
POST /api/sms/send
按条计费
成功才扣额度
回执推送
结果自动回调
HTTPS
全站加密传输
curl -X POST https://jh.fzywl.cn/api/sms/send \
  -H "Authorization: Bearer {API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"phone":"13800138000","content":"123456"}'

// 返回
{"code":0,"msg":"success","data":{"call_id":123,"status":"success","deducted":true}}

核心能力

从「发出去」到「知道发没发出去」,整条链路都做完了,接入只需要一次 HTTP 调用。

验证码短信

注册、登录、找回密码等场景的验证码下发,一条 content 即可发送,签名与模板由平台统一维护。

模板自动报备

提交模板后平台自动送审并跟踪审核状态;已通过的模板发送时自动复用,相同内容不会重复申请。

发送结果回执

配置一个回调地址,每次调用的结果自动 POST 给你(带 HMAC 签名),不用轮询;失败自动重试。

幂等防重

请求带 X-Request-Id(比如你的订单号),网络重试不会重复发送、不会重复扣费。

频控与内容预检

同一号码默认 3 条/分钟、10 条/小时、20 条/天;发送前本地违规词预检,命中直接拦下(不计费)。

全链路可追溯

调用日志记录调用网站、来源 IP、耗时、上游流水号,手机号与内容脱敏展示,便于排查与对账。

适用场景

验证码类短信由用户主动触发,到达率与合规性都更有保障。

注册 / 登录验证

App、小程序、网站的手机号注册与短信验证码登录,防止撞库与批量注册。

找回密码 / 安全验证

重置密码、修改绑定、敏感操作二次验证,给账号加一道保险。

业务通知提醒

订单状态、发货提醒、审核结果等通知类短信(需按通知类模板报备)。

系统集成 / 服务商

系统集成商把短信能力封装进自己的产品,统一调用、统一对账。

计费与规格

按「条」计费,发送成功才扣额度;失败、被内容预检拦下、因限流拒绝都不扣。

项说明
计费方式成功下发扣 1 条额度;额度不足返回 402
额度有效期见购买页套餐说明(长期有效,充值/购买即时到账)
支持范围中国大陆手机号(+86);国际号码请用语音或国际短信
接口限流每个 API Key 默认 20/分钟、200/小时、800/天,可在控制台自助调整
同一号码默认 3 条/分钟、10 条/小时、20 条/天
套餐价格见服务与价格(明码标价,无隐藏费用)

支付方式:支付宝、微信、好友代付、账户余额。

四步接入

从注册到发出第一条短信,通常 10 分钟内完成。

注册账号
手机号或邮箱注册,登录控制台。
购买额度
在「计费与套餐」选购短信套餐,额度即时到账。
生成 API Key
控制台「API Key」生成 sms 类型 Key,可配 IP 白名单与限流。
调用接口
按文档 POST 调用;建议同时配置结果回执地址。

常见问题

为什么发送前要提交模板审核?
运营商与上游要求短信内容必须是已报备的模板。提交后平台自动送审并跟踪状态,通过后发送时自动复用;相同内容的模板不会重复申请。
调用成功但用户没收到怎么办?
先用「发送状态查询」或回执推送看最终状态;常见原因是号码停机/空号、被手机管家拦截、或通道瞬时不稳(可重试一次)。把 call_id 发给客服可查上游返回。
返回 429 是什么意思?
触发限流。可能是该 API Key 触发了频次限制(控制台可调整),也可能是同一号码触发频控(防短信轰炸)。响应头会给出剩余次数。
会不会重复发送、重复扣费?
给每笔业务带上 X-Request-Id(如订单号)即可:同一 ID 的重复请求只发送一次,第二次直接返回上次结果且不扣费。
怎么知道是哪个网站在调用?
请求带上 X-Site 头(或在 Key 上配置默认回执地址),后台调用日志的「调用网站」列就会显示出你的站点,便于对账。

现在就能发一条试试

注册即得控制台,在线测试页填上自己的 API Key 就能发一条真实短信。