全栈式风控引擎
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 全栈式风控引擎 > API文档 > 数据结构

数据结构

最近更新时间：2024-04-16 01:17:51

我的收藏

本页目录：

AccountInfo

账号信息。

被如下接口引用：ManageMarketingRisk。

名称 类型 必选 描述
AccountType Integer 是 用户账号类型；默认开通QQOpenId、手机号MD5权限；如果需要使用微信OpenId入参，则需要"提交工单"或联系对接人进行资格审核，审核通过后方可正常使用微信开放账号。
1：QQ开放账号
2：微信开放账号
8：设备号，仅支持IMEI、IMEIMD5、IDFA、IDFAMD5
10004：手机号MD5，中国大陆11位手机号进行MD5加密，取32位小写值。
示例值：10004
QQAccount QQAccountInfo 否 QQ账号信息，AccountType是"1"时，该字段必填。
示例值：QQAccount.QQOpenId="A8E0232CD****2058B0EA885"
WeChatAccount WeChatAccountInfo 否 微信账号信息，AccountType是"2"时，该字段必填。
示例值：WeChatAccount.WeChatOpenId="oOya25F****4OAQCdcFo"
OtherAccount OtherAccountInfo 否 其它账号信息，AccountType是8或10004时，该字段必填。
示例值： 3ac9aa8a9a0074918763bfd6ed526ed9

InputCryptoManageMarketingRisk

全栈式风控引擎入参

被如下接口引用：ManageMarketingRisk。

名称 类型 必选 描述
IsAuthorized String 否 是否授权：1已授权，否则未授权。
调用全栈式风控引擎接口服务时，客户需先明确授权
CryptoType String 否 加密类型：1AES加密
CryptoContent String 否 加密内容，非空时接口采用加密模式。

InputDetails

入参的详细参数信息

被如下接口引用：ManageMarketingRisk。

名称 类型 必选 描述
FieldName String 是 字段名称
FieldValue String 是 字段值

InputFrontRisk

风险趋势统计--入参

被如下接口引用：DescribeRiskTrends。

名称 类型 必选 描述
EventId Integer 是 事件ID
StartTime String 否 开始时间
EndTime String 否 结束时间
Type Integer 否 趋势类型
CurrentStartTime String 否 当前开始时间
CurrentEndTime String 否 当前结束时间

InputManageMarketingRisk

全栈式风控引擎入参

被如下接口引用：ManageMarketingRisk。

名称 类型 必选 描述
Account AccountInfo 是 用户账号类型；默认开通QQOpenId、手机号MD5权限；如果需要使用微信OpenId入参，则需要"提交工单"或联系对接人进行资格审核，审核通过后方可正常使用微信开放账号。
1：QQ开放账号
2：微信开放账号
8：设备号，仅支持IMEI、IMEIMD5、IDFA、IDFAMD5
10004：手机号MD5，中国大陆11位手机号进行MD5加密，取32位小写值。
示例值：AccountInfo.AccountType= 10004
SceneCode String 是 场景码，用于识别和区分不同的业务场景，可在控制台上新建和管理
控制台链接：https://console.cloud.tencent.com/rce/risk/strategy/scene-root
活动防刷默认场景码：e_activity_antirush
登录保护默认场景码：e_login_protection
注册保护默认场景码：e_register_protection
示例值：e_activity_antirush
UserIp String 是 用户外网ip（传入用户非外网ip会影响判断结果）。
示例值：123.124.125.253
PostTime Integer 是 用户操作时间戳，精确到秒。
示例值：1615211954
UserId String 否 业务平台用户唯一标识，支持自定义。
示例值：100001
DeviceToken String 否 设备指纹DeviceToken值，集成设备指纹后获取；如果集成了相应的设备指纹，该字段必填。
示例值：v2:DJsBrn......(此处省略若干字符)jjNkBydI=
DeviceBusinessId Integer 否 设备指纹 BusinessId。
示例值：124277865452425
BusinessId Integer 否 业务ID。网站或应用在多个业务中使用此服务，通过此ID区分统计数据。
示例值：12
Nickname String 否 昵称，UTF-8 编码。
示例值：sadsad
EmailAddress String 否 用户邮箱地址。
示例值：276****396@qq.com
CheckDevice Integer 否 是否识别设备异常：
0：不识别。
1：识别。
示例值：1
CookieHash String 否 用户HTTP请求中的Cookie进行2次hash的值，只要保证相同Cookie的hash值一致即可。
示例值：fa5805903fb6b1f7e36bb1c2fd59e47684b8d180
Referer String 否 用户HTTP请求的Referer值。
示例值：fa5805903fb6b1f7e36bb1c2fd59e47684b8d180
UserAgent String 否 用户HTTP请求的User-Agent值。
示例值：Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML,
XForwardedFor String 否 用户HTTP请求的X-Forwarded-For值。
示例值：qewqeqwe
MacAddress String 否 MAC地址或设备唯一标识。
示例值：00:1A:2B:3C:4D:5E
VendorId String 否 手机制造商ID，如果手机注册，请带上此信息。
示例值：huaweiMate10pro
DeviceType Integer 否 设备类型，账号类型（AccountType）为8时填写。
1:IMEI；国际移动设备识别号（15-17位数字）；
2:IMEIMD5；国际移动设备识别号，通过MD5加密后取32位小写值；
3:IDFA；
4:IDFAMD5；国际移动设备识别号，通过MD5加密后取32位小写值。
示例值：1
Details Array of InputDetails 否 扩展字段。
示例值：Details.1.FieldName='os_system'
Sponsor SponsorInfo 否 邀请助力场景相关信息。
示例值：Sponsor.SponsorOpenId='otg-dasndasjdasldsalkjdlksad'
OnlineScam OnlineScamInfo 否 详情请跳转至OnlineScamInfo查看。
示例值：OnlineScam.ContentLabel = '诈骗'
Platform String 否 1：Android
2：iOS
3：H5
4：小程序

示例值：1

OnlineScamInfo

诈骗信息。

被如下接口引用：ManageMarketingRisk。

名称 类型 必选 描述
ContentLabel String 否 内容标签。
ContentRiskLevel Integer 否 内容风险等级：
0：正常。
1：可疑。
ContentType Integer 否 内容产生形式：
0：对话。
1：广播。
FraudType Integer 否 类型
FraudAccount String 否 账号

OtherAccountInfo

其它账号信息。

被如下接口引用：ManageMarketingRisk。

名称 类型 必选 描述
AccountId String 是 其他账号信息；
AccountType是8时，填入设备号（IMEI、IMEIMD5、IDFA、IDFAMD5）
AccountType是10004时，填入中国大陆标准11位手机号的MD5值
注释：
MD5手机号加密方式，中国大陆11位手机号进行MD5加密，加密后取32位小写值
设备号加密方式，对IMEI、IDFA明文进行MD5加密，加密后取32位小写值。
MobilePhone String 否 账号绑定的MD5手机号。
注释：只支持标准中国大陆11位手机号MD5加密后位的32位小写字符串。
DeviceId String 否 用户设备号，支持IMEI、IMEIMD5、IDFA、IDFAMD5。
注释：IMEIMD5、IDFAMD5加密方式，对IMEI、IDFA明文进行MD5加密，加密后取32位小写值。

OutputFrontRisk

风险趋势统计出参，需要为数组

被如下接口引用：DescribeRiskTrends。

名称 类型 描述
Name String 名称
注意：此字段可能返回 null，表示取不到有效值。
Value Array of OutputFrontRiskValue 参数值
注意：此字段可能返回 null，表示取不到有效值。

OutputFrontRiskData

风险趋势统计--出参

被如下接口引用：DescribeRiskTrends。

名称 类型 描述
Code Integer 返回码[0：成功；非0：标识失败错误码]。
注意：此字段可能返回 null，表示取不到有效值。
Message String 出错消息[UTF-8编码]。
注意：此字段可能返回 null，表示取不到有效值。
Value Array of OutputFrontRisk 返回结果。
注意：此字段可能返回 null，表示取不到有效值。

OutputFrontRiskValue

风险趋势统计--值

被如下接口引用：DescribeRiskTrends。

名称 类型 描述
Requests Integer 请求次数
注意：此字段可能返回 null，表示取不到有效值。
Index String 日期标签
注意：此字段可能返回 null，表示取不到有效值。

OutputManageMarketingRisk

全栈式风控引擎出参

被如下接口引用：ManageMarketingRisk。

名称 类型 描述
Code Integer 返回码。0表示成功，非0标识失败错误码。
注意：此字段可能返回 null，表示取不到有效值。
Message String UTF-8编码，出错消息。
注意：此字段可能返回 null，表示取不到有效值。
Value OutputManageMarketingRiskValue 业务详情。
注意：此字段可能返回 null，表示取不到有效值。
UUid String 控制台显示的req_id。
注意：此字段可能返回 null，表示取不到有效值。

OutputManageMarketingRiskValue

全栈式风控引擎出参值

被如下接口引用：ManageMarketingRisk。

名称 类型 描述
UserId String 账号ID：对应输入参数。
当AccountType为1时，对应QQ的OpenId。
当AccountType为2时，对应微信的OpenId/UnionId。
当AccountType为8时，对应IMEI、IDFA、IMEIMD5或者IDFAMD5。
当AccountType为10004时，对应手机号的MD5值。
注意：此字段可能返回 null，表示取不到有效值。
示例值：3ac9aa8a9a0074918763bfd6ed526ed9
PostTime Integer 操作时间戳，单位秒（对应输入参数）。
注意：此字段可能返回 null，表示取不到有效值。
示例值：1614760549
AssociateAccount String 业务参数。
注意：此字段可能返回 null，表示取不到有效值。
UserIp String 操作来源的外网IP（对应输入参数）。
注意：此字段可能返回 null，表示取不到有效值。
示例值：123.124.125.253
RiskLevel String 风险等级
pass：无恶意
review：低风险，需要人工审核
reject：高风险，建议拦截
注意：此字段可能返回 null，表示取不到有效值。
示例值：reject
RiskType Array of Integer 风险类型，可能同时命中多个风险类型
1: 账号信用低，账号近期存在因恶意被处罚历史，网络低活跃，被举报等因素。
11: 疑似低活跃账号，账号活跃度与正常用户有差异。
2: 垃圾账号，疑似批量注册小号，近期存在严重违规或大量举报。
21: 疑似小号，账号有疑似线上养号，小号等行为。
22: 疑似违规账号，账号曾有违规行为、曾被举报过、曾因违规被处罚过等。
3: 无效账号，送检账号参数无法成功解析，请检查微信 OpenId 是否有误/AppId 与 QQ OpenId 无法关联/微信 OpenId 权限是否开通/手机号是否为中国大陆手机号；
4: 黑名单，该账号在业务侧有过拉黑记录。
5: 白名单，业务自行有添加过白名单记录。
101: 批量操作，存在 IP/设备/环境等因素的聚集性异常。
1011: 疑似 IP 属性聚集，出现 IP 聚集。
1012: 疑似设备属性聚集，出现设备聚集。
102: 自动机，疑似自动机批量请求。
103: 恶意行为-网赚，疑似网赚。
104: 微信登录态无效，检查 WeChatAccessToken 参数，是否已经失效。
201: 环境风险，环境异常操作 IP/设备/环境存在异常。当前 IP 为非常用 IP 或恶意 IP 段。
2011: 疑似非常用IP，请求当前请求 IP 非该账号常用 IP。
2012: 疑似 IP 异常，使用 IDC 机房 IP 或使用代理 IP 或使用恶意 IP 等。
205: 非公网有效 IP，传进来的 IP 地址为内网 IP 地址或者 IP 保留地址。
206: 设备异常，该设备存在异常的使用行为。
2061: 疑似非常用设备，当前请求的设备非该账号常用设备。
2062: 疑似虚拟设备，请求设备为模拟器、脚本、云设备等虚拟设备。
2063: 疑似群控设备，请求设备为猫池、手机墙等群控设备。
注意：此字段可能返回 null，表示取不到有效值。
示例值：[101,201]
ConstId String 设备指纹ID，如果集成了设备指纹，并传入了正确的DeviceToken和Platform，该字段正常输出；如果DeviceToken异常（校验不通过），则会在RiskType中返回"-1"标签，ConstId字段为空；如果没有集成设备指纹ConstId字段默认为空。
注意：此字段可能返回 null，表示取不到有效值。
示例值：7BCF1420708B26034880B789
RiskInformation String 风险扩展数据。
注意：此字段可能返回 null，表示取不到有效值。
示例值：{"Model":[{"FieldName":"05103001","FieldValue":"2"}]}

QQAccountInfo

QQ账号信息。

被如下接口引用：ManageMarketingRisk。

名称 类型 必选 描述
QQOpenId String 是 QQ的OpenId。
示例值：A8E0232CD****2058B0EA885
AppIdUser String 是 QQ分配给网站或应用的AppId，用来唯一标识网站或应用。
示例值：10*60
AssociateAccount String 否 用于标识QQ用户登录后所关联业务自身的账号ID。
MobilePhone String 否 账号绑定的MD5手机号，
注释：只支中国大陆11位手机号MD5加密后位的32位小写字符串。
DeviceId String 否 用户设备号，支持IMEI、IMEIMD5、IDFA、IDFAMD5
注释：IMEIMD5、IDFAMD5加密方式，对IMEI、IDFA明文进行MD5加密，加密后取32位小写值。

SponsorInfo

网赚防刷相关参数

被如下接口引用：ManageMarketingRisk。

名称 类型 必选 描述
SponsorOpenId String 否 助力场景建议填写：活动发起人微信OpenId。
SponsorDeviceNumber String 否 助力场景建议填写：发起人设备号
SponsorPhone String 否 助力场景建议填写：发起人的MD5手机号
SponsorIp String 否 助力场景建议填写：发起人IP
CampaignUrl String 否 助力场景建议填写：活动链接

WeChatAccountInfo

微信账号信息。

被如下接口引用：ManageMarketingRisk。

名称 类型 必选 描述
WeChatOpenId String 是 微信的OpenId/UnionId。
WeChatSubType Integer 否 微信开放账号类型：
1：微信公众号/微信第三方登录。
2：微信小程序。
RandStr String 否 随机串。如果WeChatSubType是2，该字段必填。Token签名随机数，建议16个字符。
WeChatAccessToken String 否 如果WeChatSubType 是1，填入授权的 access_token（注意：不是普通 access_token，详情请参阅官方说明文档。获取网页版本的 access_token 时，scope 字段必需填写snsapi_userinfo
如果WeChatSubType是2，填入以session_key 为密钥签名随机数RandStr（hmac_sha256签名算法）得到的字符串。
AssociateAccount String 否 用于标识微信用户登录后所关联业务自身的账号ID。
MobilePhone String 否 账号绑定的MD5手机号，
注释：只支持标准中国大陆11位手机号MD5加密后位的32位小写字符串。
DeviceId String 否 用户设备号，支持IMEI、IMEIMD5、IDFA、IDFAMD5
注释：IMEIMD5、IDFAMD5加密方式，对IMEI、IDFA明文进行MD5加密，加密后取32位小写值。
中国站