|
验证码短信接口请求方式
采用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
|
|