# 获取用户安全等级
接口应在服务器端调用,详细说明参见服务端API。
本接口支持云调用。需开发者工具版本 >=
1.02.1904090
(最新稳定版下载),wx-server-sdk
>=0.4.0
# 接口说明
# 接口英文名
getUserRiskRank
# 功能描述
该接口用于根据提交的用户信息数据获取用户的安全等级 risk_rank(无需用户授权)。
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/getuserriskrank?access_token=ACCESS_TOKEN
# 云调用
出入参和HTTPS调用相同,调用方式可查看云调用示例
接口方法为: openapi.riskControl.getUserRiskRank
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:80
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token / cloudbase_access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。access_token和cloudbase_access_token二选一 其中access_token可通过getAccessToken接口获得; 如果是第三方代调用请传入authorizer_access_token; cloudbase_access_token可通过getOpenData接口获得 |
appid | string | 是 | 小程序appid |
openid | string | 是 | 用户的openid |
scene | number | 是 | 场景值,0:注册,1:营销作弊 |
mobile_no | string | 否 | 用户手机号 |
client_ip | string | 是 | 用户访问源ip |
email_address | string | 否 | 用户邮箱地址 |
extended_info | string | 否 | 额外补充信息 |
is_test | boolean | 否 | 默认值false。false:正式调用,true:测试调用 |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
risk_rank | number | 用户风险等级,合法值为0,1,2,3,4,数字越大风险越高。 |
unoin_id | number | 唯一请求标识,标记单次请求 |
# 调用示例
示例说明: HTTPS请求示例
# 请求数据示例
{
"appid":"wx*******",
"openid":"*****",
"scene":1,
"mobile_no":"12345678",
"bank_card_no":"******",
"cert_no":"*******",
"client_ip":"******",
"email_address":"***@qq.com",
"extended_info":""
}
# 返回数据示例
{
"errcode":0,
"errmsg":"getuserriskrank succ",
"risk_rank":0,
"unoin_id":123456
}
示例说明: 云函数调用示例
# 请求数据示例
const cloud = require('wx-server-sdk')
cloud.init({
env: cloud.DYNAMIC_CURRENT_ENV,
})
exports.main = async (event, context) => {
try {
const result = await cloud.openapi.riskControl.getUserRiskRank({
"appid": 'wx*******',
"openid": '*****',
"scene": 1,
"mobileNo": '12345678',
"bankCardNo": '******',
"certNo": '*******',
"clientIp": '******',
"emailAddress": '***@qq.com',
"extendedInfo": ''
})
return result
} catch (err) {
return err
}
}
# 返回数据示例
{
"errCode": 0,
"errMsg": "openapi.riskControl.getUserRiskRank:ok",
"riskRank": 0,
"unoinId": 123456
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
-1 | system error | 系统繁忙,此时请开发者稍候再试 |
40001 | invalid credential access_token isinvalid or not latest | 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口 |
40003 | invalid openid | 不合法的 OpenID ,请开发者确认 OpenID (该用户)是否已关注公众号,或是否是其他公众号的 OpenID |