riskControl.getUserRiskRank

本接口应在服务器端调用,详细说明参见服务端API

本接口支持云调用。需开发者工具版本 >= 1.02.1904090(最新稳定版下载),wx-server-sdk >= 0.4.0

根据提交的用户信息数据获取用户的安全等级 risk_rank,无需用户授权。

调用方式:

HTTPS 调用

请求地址

  1. POST https://api.weixin.qq.com/wxa/getuserriskrank?access_token=ACCESS_TOKEN

请求参数

属性类型默认值必填说明
appidstring小程序appid
openidstring用户的openid
scenenumber场景值,0:注册,1:营销作弊
mobile_nostring用户手机号
client_ipstring用户访问源ip
email_addressstring用户邮箱地址
extended_infostring额外补充信息
is_testbooleanfalse:正式调用,true:测试调用

返回值

Object

属性类型说明
errcodenumber返回码
errmsgstring错误信息
unoin_idnumber唯一请求标识,标记单次请求
risk_ranknumber用户风险等级

errcode 的合法值

说明最低版本
-1系统繁忙,此时请开发者稍候再试
0成功
48001小程序无该api权限
40001token 无效
40003openid无效
43104appid与openid不匹配
61010用户访问记录超时(用户未在近两小时访问小程序)

risk_rank 的合法值

说明最低版本
0风险等级0
1风险等级1
2风险等级2
3风险等级3
4风险等级4

请求数据示例

  1. {
  2. "appid":"wx*******",
  3. "openid":"*****",
  4. "scene":1,
  5. "mobile_no":"12345678",
  6. "bank_card_no":"******",
  7. "cert_no":"*******",
  8. "client_ip":"******",
  9. "email_address":"***@qq.com",
  10. "extended_info":""
  11. }

返回数据示例

  1. {
  2. "errcode":0,
  3. "errmsg":"getuserriskrank succ",
  4. "risk_rank":0,
  5. "unoin_id":123456
  6. }

云调用

云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力,需要在云函数中通过 wx-server-sdk 使用。

接口方法

  1. openapi.riskControl.getUserRiskRank

需在 config.json 中配置 riskControl.getUserRiskRank API 的权限,详情

请求参数

属性类型默认值必填说明
appidstring小程序appid
openidstring用户的openid
scenenumber场景值,0:注册,1:营销作弊
mobileNostring用户手机号
clientIpstring用户访问源ip
emailAddressstring用户邮箱地址
extendedInfostring额外补充信息
isTestbooleanfalse:正式调用,true:测试调用

返回值

Object

属性类型说明
errCodenumber返回码
errMsgstring错误信息
unoinIdnumber唯一请求标识,标记单次请求
riskRanknumber用户风险等级

errCode 的合法值

说明最低版本
0成功

riskRank 的合法值

说明最低版本
0风险等级0
1风险等级1
2风险等级2
3风险等级3
4风险等级4

异常

Object

抛出的异常

属性类型说明
errCodenumber返回码
errMsgstring错误信息

errCode 的合法值

说明最低版本
-1系统繁忙,此时请开发者稍候再试
48001小程序无该api权限
40001token 无效
40003openid无效
43104appid与openid不匹配
61010用户访问记录超时(用户未在近两小时访问小程序)

请求数据示例

  1. const cloud = require('wx-server-sdk')
  2. cloud.init({
  3. env: cloud.DYNAMIC_CURRENT_ENV,
  4. })
  5. exports.main = async (event, context) => {
  6. try {
  7. const result = await cloud.openapi.riskControl.getUserRiskRank({
  8. appid: 'wx*******',
  9. openid: '*****',
  10. scene: 1,
  11. mobileNo: '12345678',
  12. bankCardNo: '******',
  13. certNo: '*******',
  14. clientIp: '******',
  15. emailAddress: '***@qq.com',
  16. extendedInfo: ''
  17. })
  18. return result
  19. } catch (err) {
  20. return err
  21. }
  22. }

返回数据示例

  1. {
  2. "errCode": 0,
  3. "errMsg": "openapi.riskControl.getUserRiskRank:ok",
  4. "riskRank": 0,
  5. "unoinId": 123456
  6. }