风险画像数据获取接口(单条)
2022.07.06 18:37:08
接口说明
该接口用于请求用户账号风险画像结果数据。单条接口一次可请求一个用户账号的风险画像结果。支持http协议接口调用。
鉴权说明
易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权
请求
请求地址
名称 | 值 |
---|---|
HTTP URL | https://rp.dun.163.com/v1/profile/user/single/query |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
请求参数由公共参数和业务参数两部分组成,公共参数见请求公共参数
名称 | 类型 | 必填 | 最大长度 | 描述 |
---|---|---|---|---|
version | String | 是 | 4 | 接口版本号,可选值 v1 |
account | String | 是 | 128 | 查询账号 |
phone | String | 否 | 64 | 手机号码,查询账号是否为未成年人时建议携带该字段 |
请求体示例
version=v1&nonce=xxx×tamp=xxx&signature=xxx&secretId=xxx&businessId=xxx&account=123456
响应
响应结果
响应字段如下,响应通用字段已省略,详细见响应公共字段:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
data | Object | 是 | 查询结果 |
-success | Boolean | 是 | 是否查询成功 |
-taskId | String | 是 | 查询的唯一标识 |
-riskDetails | Object[] | 是 | 风险详情 |
-riskLevel | int | 是 | 风险等级,0-低风险,1-中风险,2-高风险 |
-riskModel | String | 是 | 检测模型 |
-riskType | int | 是 | 风险类型:11001-引流黑产、11002-欺诈嫌疑、11003-黑产团伙、11004-色情低俗、11005-涉政 |
-riskScore | int | 是 | 风险分值:0~1 |
-propDetails | Object | 否 | 属性详情 |
-under18 | Object | 否 | 置信度:0~1 |
-score | Double | 否 | 属性详情 |
-isUnder18 | int | 否 | 是否未成年人,0-否,1-是 |
响应体示例
{
"code":200,
"msg":"成功",
"data":{
"riskDetails":[
{
"riskLevel":1,
"riskModel":"model2",
"riskType":11002,
"riskScore":0.6
},
{
"riskLevel":2,
"riskModel":"model1",
"riskType":11001,
"riskScore":0.8
}
],
"propDetails":{
"under18":{
"score":1,
"isUnder18":1
}
},
"success":true,
"taskId":"5045100d3c80451bbcc848ead630e3e2"
}
}