weapps-plugin-yunnan v0.0.21
城市码项目子包
一、在app.js中初始化sdk
App({
globalData: {},
onLaunch: function () {
sdk.init({
appid: '',
paasid: '',
tifhost: '',
// 初始化的时候传入,将挂载到wx全局对象上面
$_ServiceConfiguration: {
methods: {
// 敏感度返回9002,去手机登录弹框弹出时回调
_phonePopOutCallBack: (res) => {
console.log('_phonePopOutCallBack------', res)
}
}
}
})
}
})
二、引入sdk
const sdk = require('weapps-plugin-yunnan-request')
三、使用sdk
- 业务应用需要用户登录时,调取的方法:sdk.login()
sdk.login().then(res ={
console.log('登录成功返回的数据', res)
})
- 查看认证信息,调用会话方法:sdk.getSession()
sdk.getSession({
success: res ={
console.log('获取会话成功返回的数据', res)
},
fail: err ={
console.log('获取会话失败返回的数据', err)
}
})
cid_type | 证件类型 |
---|---|
10 | 大陆居民身份证 |
14 | 港澳居民来往内地通行证 |
15 | 台湾居民来往大陆通行证 |
17 | 港澳居民居住证 |
18 | 台湾居民居住证 |
20 | 护照、普通护照 |
34 | 外国人永久居留证 |
11 | 外交护照 |
12 | 公务护照 |
13 | 因公普通护照 |
16 | 一次性台湾居民来往大陆通行证 |
30 | 外国人出入境证 |
person_type | 人员类型 |
---|---|
10 | 大陆居民 |
11 | 港澳居民 |
12 | 台湾居民 |
13 | 华侨 |
14 | 外国人 |
- 进行用户可信身份核验时,请求方法:sdk.request()
sdk.request({
url: '',
method: '',
header: {
id: 'xxxx'
},
data: {
name: '张三'
},
hideLoadingWhenSucc: true,
success: res => {
console.log('敏感度返回---', res)
},
fail: fail => {
console.log('未登陆')
}
})
- 进行原子身份实名核验服务时,调取的方法:sdk.realNameVerify()
sdk.realNameVerify().then(res ={
console.log('原子身份核验服务(实名)成功返回的数据', res)
})
- 进行原子身份实人核验服务时,调取的方法:sdk.realPeopleVerify({needBack: 1})
sdk.realPeopleVerify({needBack: 1}).then(res ={
console.log('原子身份核验服务(实人)成功返回的数据', res)
})
- 跳转到登录设置页面时,调取的方法:sdk.toLoginSet()
sdk.toLoginSet().then(res => {
console.log('退出登录设置完成', res)
})
- 非原子认证---不调用敏感度接口,直接去进行本人实名/实人认证,调取的方法:sdk.goToAuth() 传递的参数:authType 默认:realname 1、实名认证:realname 2、实人认证:realpeople
sdk.goToAuth({authType: 'realname'}).then(res => {
console.log('非原子核验 -- 实名/实人验证返回:', res)
})
一、语言国际化(默认简体中文)
- 中文大陆切换方式:sdk.setLocalLanguage({language: 'zh_CN', region: 'CHN'})
- 中文非大陆切换方式:sdk.setLocalLanguage({language: 'zh_CN', region: '!CHN'})
英文非大陆切换方式:sdk.setLocalLanguage({language: 'en', region: '!CHN'})
language 释义 zh_CN 简体中文 en 英文 region 释义 CHN 大陆 !CHN 非大陆
二、大陆居民代人打卡--实人核验服务
- 调取的方法:sdk.realPeopleVerify({needBack: 2})
sdk.realPeopleVerify({needBack: 2}).then(res => {
console.log('代人打卡(实人)成功返回的数据', res)
})
三、 非大陆居民本人登录/认证
- 方式1.借用敏感度接口,sdk会根据接口返回进行跳转。
- 方式2.根据session接口返回字段判断,业务侧前端主动调用:
- 去登录:sdk.login()
去认证:sdk.goToAuth({authType: 'realname'}) 不传则默认:'realname'
sdk.login().then(res => { console.log('登录成功---', res) }) sdk.goToAuth({authType: 'realname'}).then(res => { console.log('非原子核验 -- 实名/实人验证返回:', res) })
四、 非大陆居民添加家庭成员--实名核验服务
调取的方法:sdk.realNameVerify({needBack: 1})
sdk.realNameVerify({needBack: 1}).then(res => { console.log('原子身份核验服务(实名)成功返回的数据', res) })
五、小结:
一、 本人
登录:sdk.login()
认证:sdk.goToAuth()
二、添加家庭成员
大陆:sdk.realPeopleVerify({needBack: 1})
非大陆:sdk.realNameVerify({needBack: 1})
三、代人打卡
大陆:realPeopleVerify({needBack: 2})
四、语言国际化能力切换(默认简体中文)
中文大陆:sdk.setLocalLanguage({language: 'zh_CN', region: 'CHN'})
中文非大陆:sdk.setLocalLanguage({language: 'zh_CN', region: '!CHN'})
英文非大陆:sdk.setLocalLanguage({language: 'en', region: '!CHN'})
四、更新内容
- 新增几个弹框提示
- 优化app.js初始化引入路径,现统一改为:require('weapps-plugin-yunnan-request')
- 增加免登录时间及登录有效期时间动态获取
- 优化部分文案描述
- 港澳、华侨、外国人实名、实人对接微信人脸识别认证
五、其他说明
- 该版本包含全人类认证
- 该版本为^2.2.0+
- 因为weapps-plugin-sichuancitycode有引用weapps-plugin-yunnan-request
- 所以weapps-plugin-yunnan-request还是要install的
- 该分支从YunNanHealthCode-2021-04-07切出,主要是将sdk由gnpm迁移到npm
六、四川健康码版本对应功能说明
- 0.0.5
- 新增几个弹框提示
- 优化app.js初始化引入路径,现统一改为:require('weapps-plugin-yunnan-request')
- 增加免登录时间及登录有效期时间动态获取
- 优化部分文案描述
港澳、华侨、外国人实名、实人对接微信人脸识别认证
0.0.6
- 退出认证登录返回hasLoginOut:true字段
登录成功之后返回hasLogin:true和phone字段
0.0.7
- 原子认证实人放开多人群核验
- sdk添加直接去实名/实人信息填写API(goToAuth),认证成功之后返回authResult: true
认证失败页面提示描述文案调整
0.0.8
- 登录有效期默认14天和6小时
登录失败加上toast提示
0.0.9
- 本地缓存统一加tif标识
限制业务敏感度频繁请求接口
0.1.0
去掉人员类别筛选,默认大陆
0.1.1
隐藏身份类型选项和证件类型选项
0.1.2
修复登录页,短屏手机footer遮住用户协议缺陷。
0.1.3
认证成功和认证失败页面样式变更
0.1.4
业务侧发起多个敏感度请求时,只弹出一个弹框。
0.1.5
增加敏感度返回9002,去手机登录弹框弹出时的全局回调
0.1.6
登录页面/实名、实人页面样式调整
0.1.7
- 敏感度接口中去掉wx.checkSession()
- 去掉app.js中认证失败回调函数(_authFailCallBack)的调用
增加sdk认证失败日志上传功能
0.1.8
未改动代码
0.1.9
临时需求==原子核验实人专门为16岁及以下,65岁及以上的人群开发调用
0.2.0
解决登录页errcode of undfined报错问题
0.2.1
原子认证和敏感度实人认证改造,16岁及以下和65岁及以上走公安和慧眼接口
0.2.2-beta
1. 增加语言国际化能力
2. 大陆居民代人打卡--实人核验服务
3. 非大陆居民本人登录/认证
4. 非大陆居民添加家庭成员
0.2.3-beta
非大陆居民(境外人员)本人登录/认证核验参数修改 -- 配合后端解决session接口返回cid_type和star_cid问题
0.2.4-beta
外国人证件修改为两种可选类型(护照和外国人永久居留证),证件号码同样不做正则校验
0.2.5-beta
修复外国人认证失败后,重新认证时姓名正则校验问题
0.2.6-beta
港澳台/外国人名字正则校验由只能输入大写英文字母改为可以输入大小写英文字母
0.2.7
认证成功和认证失败页面title英文走查
0.2.8
港澳、台姓名只允许输入中文
0.2.9-beta
1.多人群中英文切换;2.敏感度核验去掉公安认证
0.3.0-beta
敏感度核验(自主申报)去掉16岁及65岁特殊人群核验(添加亲友保留特殊人群)
0.3.1-beta
完成适老页面
0.3.3
人工审核完成
0.3.4
人工审核缺陷修复完成
0.3.5
人工审核样式修复
0.3.6
根据环境切换人工审核服务通知id
0.3.7
人工审核成功后,隐藏左上角返回按钮
0.3.8
人工审核页面,英文样式调整
0.3.9
人工审核服务通知提示优化
0.4.0
处理realname-user-info和police-auth-info页面errcode报错问题
0.4.1
非大陆人员微信支付认证开发完成
0.4.2
非大陆人员护照OCR认证开发完成
0.4.3
临时版本--暂时屏蔽港澳居民居住证和台湾居民居住证
0.4.3-beta
临时版本--暂时放开大陆人工审核按钮(给领导演示)
0.4.4-beta
1.人脸识别参数替换 2.大陆失败三次后显示人工审核按钮 3.外国人证件号码校验 4.openid报错修复
0.4.5
1.大陆人脸识别之前调用人工审核结果白名单接口
0.4.6
大陆城市服务认证识别之前人工审核增加白名单接口
0.4.7
1、大陆人员添加境外家庭码 2、境外人员添加大陆家庭码
0.4.8
1、大陆居民自主申报屏蔽人工审核按钮
0.4.8-beta
1、添加境外家庭成员按钮样式修改
0.4.9
- 1、家庭码:境外英文添加大陆,大陆添加境外,语言保持稳定
七、云南健康码版本对应功能说明
- 0.0.1
在四川健康码的基础上删减某些功能
0.0.1-beta
前后端联调完成,UI调整完成
0.0.2-beta
增加测试环境人工审核结果消息通知
0.0.2-1-beta
更换底部文案
0.0.2-2-beta
大陆人脸识别之前检查人工审核结果/境外公安认证之前检查人工审核结果
0.0.2-3-beta
增加生产环境人工审核结果消息通知
0.0.3-0-beta
1.大陆家庭码: 增加公安认证功能 2.境外个人码: a、增加微信支付认证 b、增加人工审核认证
0.0.3-1-beta
1.修复大陆家庭码人工审核消息通知
0.0.3-2-beta
1.去掉勾选用户协议时的弹框 2.大陆和境外隐藏人工审核按钮
0.0.3-3-beta
1.去掉登录页勾选用户协议时的弹框
0.0.3-4-beta
1.大陆正则去掉港澳台仅保留大陆身份证 2. 外国人姓名,支持中文和英文 3.加大协议勾选框的大小,增加未勾选时边框变红提示 4.更改大陆实名、实人输入框的样式和交互
0.0.3-5-beta
统一文件名
由gnpm迁移到npm
0.0.3-6-beta
- 1.大陆自主申报实名/实人认证失败之后,调用人工审核+白名单接口
2.境外自主申报实名认证失败之后,调用人工审核+白名单接口
0.0.3-6
同0.0.3-6-beta版本
0.0.4(仅供云南测试小程序使用)
由于云南测试小程序没有支付认证权限,故同将境外个人白名单核验接口调至支付认证之前
0.0.5
同0.0.3-6版本
0.0.6
增加同行人(家庭码)协议文字
0.0.8
去掉登录页头部
0.0.9
去掉登录页头部(英文版)
0.0.10
出入境实名认证开发(依赖有问题)
0.0.11
修复0.0.10缺陷
0.0.12
修改接口地址
0.0.13
修改港澳台对应的国籍选择交互
0.0.14
OCR功能开发
0.0.15
OCR功能完善
0.0.16
微信支付功能新增证件类型:港澳台居住证
0.0.17
调整图片压缩质量为90
0.0.18
调整图片压缩质量为100
0.0.19
境外本人实名新增港澳台居住证类型
0.0.20
出入境实名认证失败,调用白名单&人工审核接口
0.0.21
- 删除多余的页面和接口
八、小程序日志说明
- TIF.CHECKSESSIONFAIL: wx.checkSession失败日志
- TIF.LOGINFAIL: 调用wx.login失败日志
- TIF.REALNAMEFAIL: 实名失败日志
- TIF.REALPEOPLEFAIL: 实人失败日志