验证码通知短信

产品详情

短信批量发送

1、接口描述

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

支持全天24小时发送

2、请求地址

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

3、请求头说明

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

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
account	APIID(用户中心【文本短信】-【验证码/通知短信】-【产品总览】查看)	xxxxxxxx	string	是
password	1、APIKEY(用户中心【文本短信】-【验证码/通知短信】-【产品总览】查看) 2、动态密码(生成动态密码方式请看该文档末尾的说明)	xxxxxxxxx	string	是
mobile	1、不含变量手机号格式：号码之间使用英文逗号隔开，如：136xxxx1111,136xxxx2222,136xxxx3333 模板ID：对应您在平台报备过的模板ID，如：624452 模板内容：您有新的订单，请注意查收。 2、含变量手机号格式：变量之间用半\|符号隔开，如：136xxxx1111\|11111111\|菜鸟,136xxxx2222\|22222222\|京东,136xxxx3333\|3333333333\|顺丰模板ID：对应您在平台报备过的模板ID，如：624452 模板内容：您的订单号是：【变量】。已由【变量】快递发出，请注意查收。注意：单次提交最少2个号码，最多5000个号码模板ID和模板内容二选一，如果传模板内容或者号码数量超过500都会进入人工审核流程。	136xxxxxxxx	string	是
content	模板内容	您的订单号是：【变量】。已由【变量】快递发出，请注意查收	string	否
templateid	短信模板ID	1	string	否
time	Unix时间戳（10位整型数字，当使用动态密码方式时为必填）	1623643787	string	否

5、响应参数

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

6、响应状态码说明

code	msg
0	提交失败
2	提交成功
400	非法ip访问
401	帐号不能为空
402	密码不能为空
403	手机号码不能为空
4031	手机号码必须大于1个
4032	手机号码必须小于5000个
404	模板ID模和模板内容二选一
4041	模板ID不正确
405	API ID 或 API KEY 不正确
4050	账号被冻结
40501	动态密码已过期
40502	动态密码校验失败
40505	没有签定合同
4051	剩余条数不足
4052	访问 ip 与备案 ip 不符
4053	用户不存在
4054	帐户无效
406	手机格式不正确
407	短信内容含有敏感字符
4070	签名格式不正确
4074	短信内容包含 emoji 符号
4075	签名未通过审核
4077	短信变量内容含有敏感字符
408	定时发送时间无效（大于当时间10分钟，小于当前时间7天）
409	计费错误

7、GET传参示例

https://api.ihuyi.com/sms/SubmitBatch.json?account=xxxxxxxx&password=xxxxxxxxx&mobile=136xxxxxxxx&content=您的订单号是：【变量】。已由【变量】快递发出，请注意查收&templateid=1&time=1623643787

8、响应示例

示例（成功）

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

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

示例（失败）

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

{"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、代码示例

5分钟快速自助开通免费体验账户