营销反作弊

有关营销反作弊的产品和接入介绍,详见 营销反作弊

my.ap.preventCheat

支持版本>=1.12.0,低版本需要做兼容处理

入参说明

名称类型必填描述
pidString小程序的开放平台账号
appIdStringArray小程序对应的APPID
biz_contextMap需要识别的业务参数
successFunction调用成功的回调函数
failFunction调用失败的回调函数
completeFunction调用结束的回调函数(调用成功、失败都会执行)

biz_context参数说明


参数

类型

是否必填

最大长度

描述

示例值

service

String



128

合作伙伴匹配服务类型,请按照示例值填写

固定传marketing

risk_type

String



1024

风险策略类型,请按照示例值填写

固定传riskinfo_anticheat_common

mobile_no

String



128

用于输入用户注册的手机号码。

13810935692

pid

String



128

申请业务合作伙伴ID

20881111222222

user_id

String



128

支付宝用户ID

20881111222233

bank_card_no

String



128

银行卡号

62223456765456

cert_no

String



128

用于输入用户的身份证号码

230109199911110921

client_ip

String



128

账户登录IP

192.168.0.1

email_address

String



128

邮箱账号

zhifubao@163.com

imei

String



128

手机序列号

865736031418584

imsi

String



128

国际移动用户识别码

460001234567890

mac_address

String



128

mac地址或设备唯一标识

42.118.71.72

extended_info

String



2048

拓展字段,其余信息通过此字段进行传输:

业务约定:

nickname:账户昵称;

reg_time:账户注册时间



"extended_info": { " nickname": "小蚂蚁"," reg_time": "2018-10-01 00:00:09" }

success 返回值

名称类型描述
resultObject风险识别的返回结果

result说明


名称

类型

描述

示例值

riskResult

String

风险识别结果:

riskinfo_anticheat_common—风险评级结果

rank0 信息不足/参数有误

rank1 表示用户作弊风险为低

rank2 表示用户作弊风险为中

rank3 表示用户作弊风险为高



riskinfo_anticheat_common_infocode—风险评级说明

171-作弊风险

{\"riskinfo_anticheat_common\":\"rank3\",\"riskinfo_anticheat_common_infocode\":\"171\"}

riskResultDesc

String

风险信息描述

{\"rank0\":\"等级0\"}

uniqueId

String

业务唯一识别码

用户标识请求信息

0b92uueie87636222

fail 返回值

名称类型描述
errorString识别错误码
errorMessageString识别错误信息

错误码说明


错误码(errorMessage)

错误明细

解决方案

serviceNoAuth

服务未授权

请检查配置的账户是否有当前接口权限

以及service参数是否正确

riskTypeNoAuth

场景(risktype)未授权

请检查risktype参数是否正确

bizContentEmpty

风险数据内容为空

检查入参格式

paramMissingError

参数缺失

检查必传参数是否传入

param error

参数错误

检查入参格式是否符合文档要求

SYSTEM_OUT_ERROR

系统繁忙

请稍后再试

INVALID_PARAMETER

缺少必选参数或参数有误

检查参数是否正确或者缺失

OVER_LIMIT

超过调用量限制

如需增加额度,请发邮件至RiskGoCSC@service.alipay.com进行申请

代码示例

  1. my.ap.preventCheat({
  2. pid:'2088121134567898',
  3. appId:'2018121134567898',
  4. bizContext: {
  5. "service": "marketing",
  6. "risk_type": "riskinfo_anticheat_common",
  7. "pid": "2088121134567898",
  8. "mobile_no": "18511897888",
  9. "user_id": "20889883883838388",
  10. "bank_card_no": "18988888888",
  11. "client_ip": "null",
  12. "email_address": "null",
  13. "imei": "null",
  14. "imsi": "null",
  15. "mac_address": "null",
  16. "extended_info": "null"
  17. },
  18. success(e) {
  19. },
  20. })

原文: https://docs.alipay.com/mini/api/antimarketcheat