概述与资源

本文是OnePass API 小程序的部署文档,用于指导 OnePass API 小程序的集成。

安装

1.页面引用 onepasswx.js

2.OnePass 小程序 推荐逻辑

(1) 初始化onepass对象

说明: 在初始化onepass前可调用小程序 wx.getNetworkType方法进行网络判断后,判断是否提前获运营商参数 pre_init; 该方法可提升非纯4G网络环境下用户的使用体验,为可选方法,不使用该方法不影响正常接入使用


wx.getNetworkType({
success (res) {
let is_pre = false;
if(res.networkType!== 'wifi' && res.networkType !== 'none'){
is_pre = true;
}else {
//可以提示用户'请关闭WIFI,打开数据流量进行体验'。开发者可自定义;
}
// 初始化onepass对象
this.opInstance = new Onepass({
app_id: '您申请的ID',
timeout: 3000,// 超时时间
pre_init: is_pre // 是否初始化时获取运营商参数;默认为true
})
}
})

(2) 调用gateway方法,返回运营商地址

this.opInstance.gateway('phone', function(err, url){
if(!err){
// 设置image控件的src属性
that.setData({ operator_url: url })
} else {
// 失败,调用短信
}
})

(3) wxml文件中放入一个image控件,image的图片地址是运营商地址

说明: 用户如果有多次请求gateway接口的业务需要,请在调用gateway方法前将image里的路径清空;this.setData({ operator_url: '')

<image style='width: 0; height:0' wx:if="operator_url" bindload='imgload' binderror='imgload' referrerPolicy="no-referrer" src="{{operator_url}}"></image>

(4) 在image控件的load和error事件处理函数中调用onepass的getTokenStatus方法

this.opInstance.getTokenStatus(function(err, data){
if(!err){
// token调用成功,获取accesscode后调用check gateway接口,服务端校验是否成功

} else {
// 失败,调用短信
}
})

(5) 前往小程序后台添加request合法域名

配置列表

服务器配置 地址
request合法域名 https://onepass.geetest.com
https://id6.me
https://www.cmpassport.com
https://opencloud.wostore.cn
https://nishub1.10010.com:38750

Request合法域名在小程序开发后台(开发>开发设置)中设置,配置时请注意将上方地址全部加入到列表里,配置成功后需要大约10分钟左右后生效(小程序规定)

说明: 开发者在本地进行移动网络调试时,需要在真机调试模式下进行调试。

引用

返回码