YOA云应用
全网首创机主拨号核验手机号
接口说明
- 适用于任何需要通过短信验证码核验机主身份的场景,完全取代短信验证码,预防验证码诈骗
- 上行拨号,避免了通常接收短信验证码等待时间长或被手机拦截的烦恼,全程快速高效,机主不会产生任何费用
- 注册/登录:提高用户注册和登录的安全性和便捷性,防止恶意攻击和虚假注册
体验一下
|
免费拨打核验电话:18805690051
出现 “核验完成” 的提示后,挂断即可,不会产生任何费用
如果没有获取验证码及“核验完成”的提示,可以再次拨打 180″
核验完成
|
发起请求
- 调用地址:https://yanhao.yoa.cn/cgi-bin/create/
- 请求方式:POST(请使用https协议)
| 参数 | 类型 | 是否必须 | 说明 |
| appid | string | true | 请求凭证 |
| secret | string | true | 请求密钥 |
| phone | string | true | 待核验号码 |
$.post("https://yanhao.yoa.cn/cgi-bin/create/",{
appid:"thzd8u9pyrveyrc4hz",
secret:"Vbud8TCE20Aqz6B5cFtup8DAMZqr3cYY",
phone:"18955294144"
},function(data,status){
if (status == "success"){
if (data.errcode == 0 && data.errmsg == "ok") {
var orderid = data.orderid //正确返回工单号
…… …… //执行查询代码
}
}
})
|
| 正常返回工单号orderid,凭此工单号查询核验状态,JSON数据包示例如下: |
{"errcode":0,"errmsg":"ok","orderid":"2405161300377416624246680"} |
| 错误时返回错误码等信息,JSON数据包示例如下: |
{"errcode":4002,"errmsg":"无效的appid"} |
查询状态
- 调用地址:https://yanhao.yoa.cn/cgi-bin/query/
- 请求方式:POST(请使用https协议)
| 参数 | 类型 | 是否必须 | 说明 |
| appid | string | true | 请求凭证 |
| secret | string | true | 请求密钥 |
| orderid | string | true | 发起返回的工单号 |
var timeoutId = setInterval(function(){ //循环查询,建议设置循环次数(时长)
$.post("https://yanhao.yoa.cn/cgi-bin/query/",{
appid:"thzd8u9pyrveyrc4hz",
secret:"Vbud8TCE20Aqz6B5cFtup8DAMZqr3cYY",
orderid:orderid //发起返回的工单号
},function(data,status){
if (status == "success"){
if (data.errcode == 0 && data.errmsg == "ok") {
clearInterval(timeoutId); //取消循环定时器
…… …… //核验成功
}
}
})
},1000)
|
| 核验成功,返回json |
{"errcode":0,"errmsg":"ok"} |
完整示例
var appid = "thzd8u9pyrveyrc4hz"
var secret = "Vbud8TCE20Aqz6B5cFtup8DAMZqr3c"
$.post("https://yanhao.yoa.cn/cgi-bin/create/",{
appid:appid,
secret:secret,
phone:"18955294144"
},function(data,status){
if (status == "success") {
if (data.errcode == 0 && data.errmsg == "ok") {
var orderid = data.orderid; //正确返回工单号
var times = 180; //循环次数(时长)
var timeoutId = setInterval(function() {
times = times - 1;
$.post("https://yanhao.yoa.cn/cgi-bin/query/",{
appid:appid,
secret:secret,
orderid:orderid //发起返回的工单号
},function(data,status){
if (status == "success"){
if (data.errcode == 0 && data.errmsg == "ok") {
clearInterval(timeoutId); //取消循环定时器
…… …… //核验成功
} else if (data.errcode == 4202) {
…… …… //等待机主拨号,页面如果有显示倒计时可在此处减少(建议)
} else {
…… …… //核验错误返回
}
}
})
},1000)
} else {
…… …… //发起错误返回
}
}
})
|
| 返回码 | 说明 |
| 0 | 请求成功,状态=ok |
| 4001 | 无效的appid |
| 4002 | secret错误 |
| 4003 | 调用接口的IP地址不在白名单中 |
| 4101 | 余额不足 |
| 4102 | 待核验号码输入不规范 |
| 4103 | 待核验号码不是运营商提供的有效号码 |
| 4201 | 工单号错误 |
| 4202 | 继续等待机主拨号 |
| 4203 | 查询超时 |