所有文档

短信服务

语音服务

个人信息核验

运营商信息核验

银行信息核验

企业信息核验

车辆出行

应用开发

文字识别

数字权益

企业服务

基础知识

开发参考

文档中心 > 短信服务 > 验证码通知短信

验证码通知短信

产品详情

短信单条发送

1、接口描述

请求支持 POST 和 GET 两种方法，字符编码为 utf-8。

支持全天24小时发送

2、请求地址

https://api.ihuyi.com/sms/Submit.json

3、请求头说明

参数名称	参数值描述	示例	类型	必填
Content-Type	内容类型，固定值	application/x-www-form-urlencoded	string	是

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
account	APIID(用户中心【文本短信】-【验证码/通知短信】-【产品总览】查看)	xxxxxxxx	string	是
password	1、APIKEY(用户中心【文本短信】-【验证码/通知短信】-【产品总览】查看) 2、动态密码(生成动态密码方式请看该文档末尾的说明)	xxxxxxxxx	string	是
mobile	根据发送方式不同： 1、完整内容方式提交完整的短信内容，如：您的验证码是：1234。请不要把验证码泄露给其他人。 2、模板变量方式模板中的变量内容，多个变量以英文竖线（\|）隔开 ①单变量示例模板内容：您的验证码是：【变量】。请不要把验证码泄露给其他人。参数写法：content=1234 最终短信为：您的验证码是：1234。请不要把验证码泄露给其他人。 ②多变量示例模板内容：订单号：【变量1】，联系人：【变量2】，手机号：【变量3】，金额：【变量4】。参数写法：content=20180515006\|张三\|136xxxxxxxx\|100元最终短信为：订单号：20180515006，联系人：张三，手机号：136xxxxxxxx，金额：100元。支持500字以内的长短信，长短信按多条计费	136xxxxxxxx	string	是
content	短信内容，注：模板ID为空时必填	您的验证码是：1234。请不要把验证码泄露给其他人。	string	否
templateid	短信模板ID（使用模板变量方式发送时必填）调试阶段可使用系统默认模板ID：1（模板内容为：您的验证码是：【变量】。请不要把验证码泄露给其他人。）	1	string	否
time	Unix时间戳（10位整型数字，当使用动态密码方式时为必填）	1623643787	string	否

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	返回值为2时，表示提交成功	2\|1	int	是
msg	提交结果描述	提交成功\|提交失败	string	是
smsid	当提交成功后，此字段为流水号，否则为0或空	16236437872836\|0	string	否

6、响应状态码说明

code	msg
0	提交失败
2	提交成功
400	非法ip访问
401	帐号不能为空
402	密码不能为空
403	手机号码不能为空
4030	手机号码已被列入黑名单
404	短信内容不能为空
405	API ID 或 API KEY 不正确
4050	账号被冻结
40501	动态密码已过期
40502	动态密码校验失败
40504	超出每天最大发送量
40505	没有签定合同
4051	剩余条数不足
4052	访问 ip 与备案 ip 不符
4053	用户不存在
4054	帐户无效
406	手机格式不正确
407	短信内容含有敏感字符
4070	签名格式不正确
4071	没有提交备案模板
4072	提交的短信内容与审核通过的模板内容不匹配
40722	变量内容超过指定的长度【8】
4073	短信内容超出长度限制
4074	短信内容包含 emoji 符号
4075	签名未通过审核
4077	短信变量内容含有敏感字符
408	发送超限【50】条，已加入黑名单，可登入平台解除
4082	超出同一手机号一天之内【100】条短信限制
4085	同一手机号一天之内验证码短信发送超出【10】条
4086	提交失败

7、GET传参示例

https://api.ihuyi.com/sms/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&mobile=136xxxxxxxx&content=您的验证码是：1234。请不要把验证码泄露给其他人。&templateid=1&time=1623643787

8、响应示例

示例（成功）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>提交成功</msg><smsid>16236437872836</smsid></SubmitResult>

{    "code":
            2
        ,        "msg":
            "提交成功"
        ,        "smsid":
            "16236437872836"
            }

示例（失败）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>1</code><msg>提交失败</msg></SubmitResult>

{"code":1,"msg":"提交失败"}

9、PHP生成动态密码方式代码示例

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$mobile = '136xxxxxxxx';
$contnet = '';
$time = '1623643787';
$password=md5($account.$password.$mobile.$contnet.$time);
$password=md5('xxxxxxxxxxxxxxxxx136xxxxxxxx1623643787');

//注意：所有字符编码统一为UTF-8

验证码通知短信

短信单条发送

1、接口描述

2、请求地址

3、请求头说明

4、请求参数说明

5、响应参数

6、响应状态码说明

7、GET传参示例

8、响应示例

9、PHP生成动态密码方式代码示例

10、代码示例

免费体验

填写验证码后，点击“开通体验账户”自动开通体验账户。