账号风险画像数据获取接口(批量)
2023.04.26 16:47:57
接口说明
该接口用于请求用户账号风险画像结果数据。批量接口一次可请求多个用户账号的风险画像结果。支持http协议接口调用。
鉴权说明
易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权
请求地址
名称 | 值 |
---|---|
HTTP URL | https://rp.dun.163.com/v1/profile/user/multiple/query |
HTTP Method | POST |
请求
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
请求参数由公共参数和业务参数两部分组成,公共参数见请求公共参数
名称 | 类型 | 必填 | 最大长度 | 描述 |
---|---|---|---|---|
version | String | 是 | 4 | 接口版本号,可选值 v1 |
accounts | List |
是 | 100 | 查询账号,每次最多查询100个账号 |
请求体示例
version=v1&nonce=xxx×tamp=xxx&signature=xxx&secretId=xxx&businessId=xxx&accounts=xxx
响应
响应结果
响应字段如下,响应通用字段已省略,详细见响应公共字段:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
data | Object | 是 | 查询结果 |
-success | Boolean | 是 | 是否查询成功 |
-taskId | String | 是 | 查询的唯一标识 |
-riskDetails | Object[] | 是 | 风险详情 |
-account | String | 是 | 检测账号 |
-riskInfoList | Object[] | 是 | 风险信息 |
-riskLevel | int | 是 | 风险等级,0-低风险,1-中风险,2-高风险 |
-riskModel | String | 是 | 检测模型 |
-riskType | int | 是 | 风险类型:11001-引流黑产、11002-欺诈嫌疑、11003-黑产团伙、11004-色情低俗、11005-涉政 |
-riskScore | int | 是 | 风险分值:0~1 |
-propDetails | Object | 否 | 属性详情 |
-under18 | Object | 否 | 未成年人标签详情 |
-score | Double | 否 | 置信度:0~1 |
-isUnder18 | int | 否 | 是否未成年人,0-否,1-是 |
响应体示例
{
"code":200,
"msg":"成功",
"data":{
"riskDetails":[
{
"riskInfoList":[
{
"riskLevel":1,
"riskModel":"model2",
"riskType":11002,
"riskScore":0.4
},
{
"riskLevel":2,
"riskModel":"model1",
"riskType":11001,
"riskScore":0.6
}
],
"propDetails":{
"under18":{
"score":1,
"isUnder18":1
}
},
"account":"123456"
},
{
"riskInfoList":[
{
"riskLevel":1,
"riskModel":"model2",
"riskType":11001,
"riskScore":0.5
}
],
"propDetails":{
"under18":{
"score":1,
"isUnder18":0
}
},
"account":"123"
}
],
"success":true,
"taskId":"12912d9a88e8497ab5f88fc3e8e82216"
}
}
接入示例代码
开发工具集(SDK)接入
为方便 JAVA 开发者调试和接入API,我们提供了配套的开发工具集(SDK),用于简化API接入流程。SDK中各接口调用方式基本相同,接入方式统一,并提供了一些接口调用过程中常见的异常处理方案。以下介绍了SDK的使用流程,以及使用SDK的简单示例。
- 准备工作
准备步骤详见通用步骤
- 使用方法
该接口的使用方法可参考SDK demo