互亿无线-支持社区

标题: 互亿无线验证码短信接口文档 [打印本页]

作者: admin 时间: 2016-11-22 22:54
标题: 互亿无线验证码短信接口文档
验证码短信接口请求方式
采用http或者https（安全连接）协议，支持Get及Post方式进行通讯。

验证码短信接口编码格式
UTF-8

接口地址
Get方式

http://106.ihuyi.com/webservice/sms.php?method=Submit&account=用户名&password=APIKEY&mobile=手机号码&content=您的验证码是：1234。请不要把验证码泄露给其他人。

复制代码

Post方式

http://106.ihuyi.com/webservice/sms.php?method=Submit

复制代码

接口参数

参数名称	说明
method	Submit
account	用户名
password	1.APIKEY（账户及签名设置处查看） 2.签名方式（生成签名方式请看文档最后的说明）
mobile	接收的手机号码，一次只能提交一个号码
content	短信内容（支持300个字的长短信，长短信按多条计费）
time	Unix时间戳（当password为签名方式时为必填）

返回值SubmitResult结构说明

参数	类型	描述
code	int	返回值为2时，表示提交成功
smsid	string	仅当提交成功后，此字段值才有意义（消息ID）
msg	string	提交结果描述

返回值SubmitResult枚举

Code	Msg
0	提交失败
2	提交成功
400	非法ip访问
401	帐号不能为空
402	密码不能为空
403	手机号码不能为空
4030	黑名单号码
404	短信内容不能为空
405	用户名或密码不正确
4050	账号被冻结
4051	余额不足
4052	访问ip与备案ip不符
406	手机格式不正确
407	短信内容含有敏感字符
4070	签名格式不正确
4071	短信模板未报备
4072	短信内容与模板不匹配
4073	短信内容超出长度限制
408	您的帐户疑被恶意利用，已被自动冻结，如有疑问请与客服联系。

注：因运营商规则变化，如有返回值在上述表格中找不到，请咨询您的专属客服。

余额查询接口说明

参数名称	说明
method	GetNum
account	用户名
password	1.APIKEY（账户及签名设置处查看） 2.签名方式（生成签名方式请看文档最后的说明）

余额查询返回值GetNumResult 结构说明

参数名称	类型	说明
code	int	状态返回值
msg	string	查询结果描述
num	string	剩余数量

验证短信接口补充说明
生成签名方式
这里以PHP为例
提交短信的生成方式：

$password=md5($account.$apikey.$mobile.$content.time());

复制代码

例如：
帐号：cf_test
APIKEY：1q784322ba1d9bb88d50cf5cdfd89k7d
手机号：138xxxxxxxx
内容：您的验证码是：2546。请不要把验证码泄露给其他人。
time：1451544941
结果：

$password=md5('cf_test1q784322ba1d9bb88d50cf5cdfd89k7d138xxxxxxxx您的验证码是：2546。请不要把验证码泄露给其他人。1451544941');

复制代码

查询剩余条数的生成方式：

$password=md5($account.$apikey.time());

复制代码

例如：
帐号：cf_test
APIKEY：1q784322ba1d9bb88d50cf5cdfd89k7d
手机号：138xxxxxxxx
time：1451544941
结果：

$password=md5('cf_test1q784322ba1d9bb88d50cf5cdfd89k7d1451544941');

复制代码

Unix时间戳参考地址：http://tool.chinaz.com/Tools/unixtime.aspx

欢迎光临互亿无线-支持社区 (http://h.ihuyi.com/bbs/)