weapps-plugin-sichuancitycode v0.6.1
城市码项目子包
一、在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-sichuancitycode')
三、使用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 | 外国人永久居留证 |
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-sichuancitycode')
- 增加免登录时间及登录有效期时间动态获取
- 优化部分文案描述
- 港澳、华侨、外国人实名、实人对接微信人脸识别认证
五、其他说明
- 该版本包含全人类认证
- 该版本为^2.2.0+
- 因为weapps-plugin-sichuancitycode有引用weapps-plugin-sichuancitycode-request
- 所以weapps-plugin-sichuancitycode-request还是要install的
- 该分支从SiChuanCityCode3.1-微信支付和OCR-2021-03-17切出,主要是将sdk由gnpm迁移到npm
六、版本对应功能说明
- 0.0.5
- 新增几个弹框提示
- 优化app.js初始化引入路径,现统一改为:require('weapps-plugin-sichuancitycode')
- 增加免登录时间及登录有效期时间动态获取
- 优化部分文案描述
港澳、华侨、外国人实名、实人对接微信人脸识别认证
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.4.9-beta
1、放开港澳居民居住证、台湾居民居住证类型(仅供优特联调2021-4-19)
0.4.9-1-beta
1、去掉港、澳、台、外国人身份证号码校验
0.4.9-2-beta
1、增加国籍字段
0.4.9-3-beta
1、国籍字段增加正则校验
gnpm迁移到npm
0.4.9-4
1、同0.4.9-3-beta
0.5.0
1、同0.4.9-3-beta
0.5.1
1、同0.4.9(迁移到npm之后)
0.5.2
1、在0.4.9-3-beta基础上增加非外国人姓名正则校验
0.5.3
1、大陆/港澳/华侨姓名可以输入英文
0.5.4
1、境外人员认证失败后,显示人工审核按钮
0.5.5
1、台湾地区人员认证失败后,显示人工审核按钮
0.5.6
1、台湾地区人员认证失败后,不显示OCR认证按钮
0.5.7
1、国籍配置表新增 南苏丹共和国
0.5.8
去掉登录页首部
0.5.9
去掉登录页首部(英文版)
0.6.0
使用云函数调用接口
0.6.1
- 修改'x-wx-service'参数为大写
七、小程序日志说明
- TIF.CHECKSESSIONFAIL: wx.checkSession失败日志
- TIF.LOGINFAIL: 调用wx.login失败日志
- TIF.REALNAMEFAIL: 实名失败日志
- TIF.REALPEOPLEFAIL: 实人失败日志