查询
请求Header:
名称 | 值 | |
---|---|---|
Content-Type | application/x-www-form-urlencoded |
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
BusinessSecurityData | 是 | json | 主字段 | |
BusinessSecurityData.Account | 是 | 账号信息 | ||
BusinessSecurityData.Account.AccountType | 是 | Integer | 1:QQ开放账号。2:微信开放账号。(暂不支持)4:手机号(暂仅支持国内手机号)。8:设备号(imei/imeiMD5/idfa/idfaMD5)。0:其他。10004:支持手机号MD5加密和sha256加密; | |
BusinessSecurityData.Account.OtherAccount.AccountId | 否 | string | 其它账号信息:AccountType是4时,填入真实的手机号(如13123456789)。AccountType是8时,支持 imei、idfa、imeiMD5、idfaMD5 入参。AccountType是0时,填入账号信息。AccountType是10004时,填入手机号的MD5值。注:imeiMd5 加密方式为:imei 明文小写后,进行 MD5 密,加密后取小写值。IdfaMd5 加密方式为:idfa 明文大写后,进行 MD5 加密,加密后取小写值。BusinessSecurityData.UserIp | |
BusinessSecurityData.Account.OtherAccount | 否 | json | 其它账号信息,AccountType是0、4、8或10004时,该字段必填。 | |
BusinessSecurityData.Account.QQAcount | 否 | json | QQ账号信息,AccountType是1时,该字段必填。 | |
BusinessSecurityData.Account.WeChatAccount | 否 | json | 微信账号信息,AccountType是2时,该字段必填。 | |
BusinessSecurityData.Account.QQAcount.QQOpenId | 是 | string | QQ的OpenID。 | |
BusinessSecurityData.Account.QQAcount.AppIdUser | 是 | string | QQ分配给网站或应用的AppId,用来唯一标识网站或应用。 | |
BusinessSecurityData.Account.QQAcount.AssociateAccount | 否 | string | 用于标识QQ用户登录后所关联业务自身的账号ID | |
BusinessSecurityData.Account.QQAcount.MobilePhone | 否 | string | 账号绑定的手机号 | |
BusinessSecurityData.Account.QQAcount.DeviceId | 否 | string | 用户设备号。 | |
BusinessSecurityData.Account.WeChatAccount.WeChatOpenId | 是 | string | 微信的OpenID/UnionID | |
BusinessSecurityData.Account.WeChatAccount.WeChatSubType | 是 | string | 微信开放账号类型:1:微信公众号/微信第三方登录。2:微信小程序 | |
BusinessSecurityData.Account.WeChatAccount.RandStr | 是 | string | 随机串。如果WeChatSubType是2,该字段必填。Token签名随机数,建议16个字符。 | |
BusinessSecurityData.Account.WeChatAccount.WeChatAccessToken | 是 | string | 如果WeChatSubType是1,填入授权的access_token(注意:不是普通access_token,详情请参阅官方说明文档。获取网页版本的access_token时,scope字段必需填写snsapi_userinfo。如果WeChatSubType是2,填入以session_key为密钥签名随机数RandStr(hmac_sha256签名算法)得到的字符串。 | |
BusinessSecurityData.Account.WeChatAccount.AssociateAccount | 是 | string | 用于标识微信用户登录后所关联业务自身的账号ID。 | |
BusinessSecurityData.Account.WeChatAccount.MobilePhone | 是 | string | 账号绑定的手机号。 | |
BusinessSecurityData.Account.WeChatAccount.DeviceId | 是 | string | 用户设备号。 | |
BusinessSecurityData.UserId | 否 | string | 用户唯一标识。 | |
BusinessSecurityData.DeviceToken | 否 | string | 设备指纹token。 | |
BusinessSecurityData.DeviceBusinessId | 否 | string | 设备指纹BusinessId | |
BusinessSecurityData.BusinessId | 否 | string | 业务ID。网站或应用在多个业务中使用此服务,通过此ID区分统计数据。 | |
BusinessSecurityData.Nickname | 否 | string | 昵称,UTF-8 编码。 | |
BusinessSecurityData.EmailAddress | 否 | string | 用户邮箱地址(非系统自动生成)。 | |
BusinessSecurityData.CheckDevice | 否 | string | 是否识别设备异常:0:不识别。1:识别。 | |
BusinessSecurityData.CookieHash | 否 | string | 用户HTTP请求中的Cookie进行2次hash的值,只要保证相同Cookie的hash值一致即可 | |
BusinessSecurityData.Referer | 否 | string | 用户HTTP请求的Referer值。 | |
BusinessSecurityData.UserAgent | 否 | string | 用户HTTP请求的User-Agent值。 | |
BusinessSecurityData.XForwardedFor | 否 | string | 用户HTTP请求的X-Forwarded-For值。 | |
BusinessSecurityData.MacAddress | 否 | string | MAC地址或设备唯一标识。 | |
BusinessSecurityData.VendorId | 否 | string | 手机制造商ID,如果手机注册,请带上此信息。 | |
BusinessSecurityData.DeviceType | 否 | string | 设备类型:1:Android 2:IOS | |
BusinessSecurityData.DeviceToken | 否 | string | 设备指纹token。 | |
BusinessSecurityData.Sponsor | 否 | json | 网赚防刷相关参数 | |
BusinessSecurityData.Sponsor.SponsorOpenId | 否 | string | 助力场景建议填写:活动发起人微信OpenID | |
BusinessSecurityData.Sponsor.SponsorDeviceNumber | 否 | string | 助力场景建议填写:发起人设备号。 | |
BusinessSecurityData.Sponsor.SponsorPhone | 否 | string | 助力场景建议填写:发起人手机号。 | |
BusinessSecurityData.Sponsor.SponsorIp | 否 | string | 助力场景建议填写:发起人IP。 | |
BusinessSecurityData.Sponsor.CampaignUrl | 否 | string | 助力场景建议填写:活动链接。 | |
BusinessSecurityData.OnlineScam | 否 | json | 诈骗信息 | |
BusinessSecurityData.OnlineScam.ContentLabel | 否 | string | 内容标签。 | |
BusinessSecurityData.OnlineScam.ContentRiskLevel | 否 | Integer | 内容风险等级:0:正常。1:可疑。 | |
BusinessSecurityData.OnlineScam.ContentType | 否 | Integer | 内容产生形式:0:对话。1:广播。 | |
BusinessSecurityData.OnlineScam.FraudType | 否 | Integer | 诈骗账号类型:1:11位手机号。2:QQ账号 | |
BusinessSecurityData.OnlineScam.FraudAccount | 否 | string | 诈骗账号,手机号或QQ账号。 |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 状态码 | |
reason | string | 状态提示 | |
result | json | 返回结果 | |
result.res | json | 结果 | |
result.res.UserId | string | 账号ID。对应输入参数:AccountType是1时,对应QQ的OpenID。AccountType是2时,对应微信的OpenID/UnionID。AccountType是4时,对应手机号。AccountType是8时,对应imei、idfa、imeiMD5或者idfaMD5。AccountType是0时,对应账号信息。AccountType是10004时,对应手机号的MD5。注意:此字段可能返回 null,表示取不到有效值。 | |
result.res.PostTime | Integer | 操作时间戳,单位秒(对应输入参数)。注意:此字段可能返回 null,表示取不到有效值 | |
result.res.AssociateAccount | string | 对应输入参数,AccountType 是 QQ 或微信开放账号时,用于标识 QQ 或微信用户登录后关联业务自身的账号ID。注意:此字段可能返回 null,表示取不到有效值。 | |
result.res.UserIp | string | 操作来源的外网IP(对应输入参数)。注意:此字段可能返回 null,表示取不到有效值。 | |
result.res.RiskLevel | string | 风险值。pass : 无恶意;review:需要人工审核;reject:拒绝,高风险恶意;注意:此字段可能返回 null,表示取不到有效值。 | |
result.res.RiskType | Array of Integer | 账号风险 | |
1 账号信用低,账号近期存在因恶意被处罚历史,网络低活跃,被举报等因素 | |||
11 疑似 低活跃账号,账号活跃度与正常用户有差异 | |||
2 垃圾账号 疑似批量注册小号,近期存在严重违规或大量举报 | |||
21 疑似小号 账号有疑似线上养号,小号等行为 | |||
22 疑似违规账号 账号曾有违规行为、曾被举报过、曾因违规被处罚过等 | |||
3 无效账号 送检账号参数无法成功解析,请检查微信 openid 是否有误/appid与QQopenid无法关联/微信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,表示取不到有效值。 |
JSON返回示例:JSON在线格式化工具 >
请求示例(需以post json格式数据(key除外))
{
"BusinessSecurityData": {
"Account": {
"OtherAccount": {
"DeviceId": "xx",
"MobilePhone": "xx",
"AccountId": "xx"
},
"QQAccount": {
"QQOpenId": "xx",
"AppIdUser": "xx",
"DeviceId": "xx",
"MobilePhone": "xx",
"AssociateAccount": "xx"
},
"WeChatAccount": {
"MobilePhone": "xx",
"WeChatAccessToken": "xx",
"WeChatSubType": 1,
"DeviceId": "xx",
"AssociateAccount": "xx",
"WeChatOpenId": "xx",
"RandStr": "xx"
},
"AccountType": 4
},
"CookieHash": "xx",
"BusinessId": 1,
"DeviceType": 0,
"XForwardedFor": "xx",
"UserId": "xx",
"CheckDevice": 0,
"Details": [
{
"FieldName": "xx",
"FieldValue": "xx"
}
],
"MacAddress": "xx",
"UserAgent": "xx",
"EmailAddress": "xx",
"VendorId": "xx",
"SceneCode": "xx",
"Sponsor": {
"SponsorDeviceNumber": "xx",
"SponsorIp": "xx",
"CampaignUrl": "xx",
"SponsorOpenId": "xx",
"SponsorPhone": "xx"
},
"UserIp": "xx",
"Referer": "xx",
"OnlineScam": {
"ContentRiskLevel": 0,
"ContentLabel": "xx",
"ContentType": 0,
"FraudAccount": "xx",
"FraudType": 0
},
"Nickname": "xx",
"DeviceToken": "xx",
"DeviceBusinessId": 0
}
}
//简易请求示例
{
"BusinessSecurityData": {
"Account": {
"AccountType": 4,
"OtherAccount": {
"AccountId": "13815650338"
}
},
"UserIp": "223.122.53.5"
}
}
//返回示例
{
"reason":"成功",
"result":{
"res":{
"UserId":"13825650335",
"PostTime":1621837769,
"AssociateAccount":"",
"UserIp":"221.122.53.5",
"RiskLevel":"review",
"RiskType":[
201
]
},
"orderid":"J615202105241429295382"
},
"error_code":0
}
服务级错误码参照(error_code):
错误码 | 说明 | |
---|---|---|
261501 | 网络错误 | |
261502 | accountType错误 | |
261504 | 请填入正确的MobilePhone | |
261505 | appId不可为空 | |
261506 | userIp不可为空 | |
261507 | AccountId不可为空或格式错误 | |
261508 | 参数错误(包括参数格式、类型等错误) | |
261509 | 参数取值错误 | |
261510 | 缺少参数 | |
261511 | 未知参数错误,用户多传未定义的参数会导致错误 | |
261512 | 请求包超过限制大小。 | |
261513 | 其他错误 |
系统级错误码参照:
错误码 | 说明 | 旧版本(resultcode) | |
---|---|---|---|
10001 | 错误的请求KEY | 101 | |
10002 | 该KEY无请求权限 | 102 | |
10003 | KEY过期 | 103 | |
10004 | 错误的OPENID | 104 | |
10005 | 应用未审核超时,请提交认证 | 105 | |
10007 | 未知的请求源 | 107 | |
10008 | 被禁止的IP | 108 | |
10009 | 被禁止的KEY | 109 | |
10011 | 当前IP请求超过限制 | 111 | |
10012 | 请求超过次数限制 | 112 | |
10013 | 测试KEY超过请求限制 | 113 | |
10014 | 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) | 114 | |
10020 | 接口维护 | 120 | |
10021 | 接口停用 | 121 |
错误码格式说明(示例:200201):
2 | 002 | 01 | |
---|---|---|---|
服务级错误(1为系统级错误) | 服务模块代码(即数据ID) | 具体错误代码 |