营销反作弊
有关营销反作弊的产品和接入介绍,详见 营销反作弊。
my.ap.preventCheat
支持版本>=1.12.0,低版本需要做兼容处理
入参说明
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
pid | String | 是 | 小程序的开放平台账号 |
appId | StringArray | 是 | 小程序对应的APPID |
biz_context | Map | 是 | 需要识别的业务参数 |
success | Function | 否 | 调用成功的回调函数 |
fail | Function | 否 | 调用失败的回调函数 |
complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
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 返回值
名称 | 类型 | 描述 |
---|---|---|
result | Object | 风险识别的返回结果 |
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 返回值
名称 | 类型 | 描述 |
---|---|---|
error | String | 识别错误码 |
errorMessage | String | 识别错误信息 |
错误码说明
错误码(errorMessage) | 错误明细 | 解决方案 |
serviceNoAuth | 服务未授权 | 请检查配置的账户是否有当前接口权限 以及service参数是否正确 |
riskTypeNoAuth | 场景(risktype)未授权 | 请检查risktype参数是否正确 |
bizContentEmpty | 风险数据内容为空 | 检查入参格式 |
paramMissingError | 参数缺失 | 检查必传参数是否传入 |
param error | 参数错误 | 检查入参格式是否符合文档要求 |
SYSTEM_OUT_ERROR | 系统繁忙 | 请稍后再试 |
INVALID_PARAMETER | 缺少必选参数或参数有误 | 检查参数是否正确或者缺失 |
OVER_LIMIT | 超过调用量限制 | 如需增加额度,请发邮件至RiskGoCSC@service.alipay.com进行申请 |
代码示例
my.ap.preventCheat({
pid:'2088121134567898',
appId:'2018121134567898',
bizContext: {
"service": "marketing",
"risk_type": "riskinfo_anticheat_common",
"pid": "2088121134567898",
"mobile_no": "18511897888",
"user_id": "20889883883838388",
"bank_card_no": "18988888888",
"client_ip": "null",
"email_address": "null",
"imei": "null",
"imsi": "null",
"mac_address": "null",
"extended_info": "null"
},
success(e) {
},
})