所有文档

短信服务

语音服务

个人信息核验

运营商信息核验

银行信息核验

企业信息核验

车辆出行

应用开发

文字识别

数字权益

企业服务

基础知识

开发参考

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

验证码通知短信

产品详情

提交模板

1、接口描述

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

2、请求地址

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

3、请求头说明

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

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
account	APIID(用户中心【文本短信】-【验证码/通知短信】-【产品总览】查看)	xxxxxxxx	string	是
password	1、APIKEY(用户中心【文本短信】-【验证码/通知短信】-【产品总览】查看) 2、动态密码(生成动态密码方式请看该文档末尾的说明)	xxxxxxxxx	string	是
content	模板内容	您的验证码是：【变量】，【变量】分钟内有效。	string	是
content2	实际发送的内容	您的验证码是：123456，5分钟内有效。	string	是
type	类型（1验证码 2通知）	1	int	是
scene	使用场景	新用户注册	string	是
time	Unix时间戳（10位整型数字，使用动态密码方式时必填）	1623643787	string	否

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	返回值为2时，表示添加成功。	2\|0	int	是
msg	结果描述	添加成功\|添加失败	string	是
templateid	添加成功则返回模板ID	123456\|0	int	否

6、响应状态码说明

code	msg
2	添加成功
400	非法ip访问
401	用户名不能为空
402	密码不能为空
404	模板内容不能为空
4041	模板内容长度不符合（15-500个字符）
4042	使用场景长度为50个字符以内
4043	实际发送的内容（示例）不能为空
4044	实际发送的内容（示例）长度不符合（15-500个字符）
405	API ID 或 API KEY 不正确
4050	账号被冻结
40501	动态密码已过期
40502	动态密码校验失败
406	未充值不能提交模板
4066	添加太频繁，支持1分钟10次请求
407	模板内容含有敏感字符
408	模板己存在

7、GET传参示例

https://api.ihuyi.com/sms/AddTemplate.json?account=xxxxxxxx&password=xxxxxxxxx&content=您的验证码是：【变量】，【变量】分钟内有效。&content2=您的验证码是：123456，5分钟内有效。&type=1&scene=新用户注册&time=1623643787

8、响应示例

示例（成功）

<?xml version="1.0" encoding="utf-8"?><AddTemplateResult><code>2</code><msg>添加成功</msg><templateid>123456</templateid></AddTemplateResult>

{    "code":
            2
        ,        "msg":
            "添加成功"
        ,        "templateid":
            123456
            }

示例（失败）

<?xml version="1.0" encoding="utf-8"?><AddTemplateResult><code>0</code><msg>添加失败</msg></AddTemplateResult>

{"code":0,"msg":"添加失败"}

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

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$content = '您的验证码是：【变量】，【变量】分钟内有效。';
$time = '1623643787';
$password=md5($account.$password.$content.$time);
$password=md5('xxxxxxxxxxxxxxxxx您的验证码是：【变量】，【变量】分钟内有效。1623643787');

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

验证码通知短信

提交模板

1、接口描述

2、请求地址

3、请求头说明

4、请求参数说明

5、响应参数

6、响应状态码说明

7、GET传参示例

8、响应示例

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

10、代码示例

免费体验

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