风险画像数据上报接口
2023.04.26 16:47:57
接口说明
该接口用于上报用户行为数据,用以进行画像分析,具体检测结果需要通过“账号风险画像数据获取接口”来获取。 支持http协议接口调用。
鉴权说明
易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权
上传内容限制
- 限制:单次批量提交1-100条,单条<1万字符,字段长度不可超过1万字符,否则会上传失败
请求地址
名称 | 值 |
---|---|
HTTP URL | https://rp.dun.163.com/v1/profile/user/async/check |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
请求参数由公共参数和业务参数两部分组成,公共参数见请求公共参数
名称 | 类型 | 必填 | 最大长度 | 描述 |
---|---|---|---|---|
version | String | 是 | 4 | 接口版本号,可选值 v1 |
texts | String | 是 | 1-100条文本数据 | 文本数据,json格式对象数组 |
-dataId | String | 是 | 128 | 数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
-content | String | 是 | 10000 | 用户发表内容,建议对内容中JSON、表情符、HTML标签、UBB标签等做过滤,只传递纯文本,以减少误判概率 |
-publishTime | Number | 是 | 13 | 发表时间,UNIX 时间戳(毫秒值) |
-account | String | 是 | 64 | 用户唯一标识,与易盾账号画像库匹配 |
-receiveUid | String | 是 | 64 | 接受消息的用户标识,私聊/评论回复场景使用,易盾可根据该id关联检测,辅助精准调优 |
-ip | String | 是 | 128 | 用户IP地址,与易盾IP画像库匹配 |
-phone | String | 是 | 64 | 手机号,与易盾风险库匹配。默认国内手机号,如有海外手机,需包含国家地区代码,格式为“+447410xxx186(+44即为国家码)”。如果需要加密,支持传入hash值,hash算法:md5(phone) |
-title | String | 否 | 512 | 内容标题,适用于贴子、博客的文章标题等场景,建议抄送 |
请求体示例
version=v1&nonce=xxx×tamp=xxx&signature=xxx&secretId=xxx&businessId=xxx&texts=xxx
响应
响应结果
响应字段如下,响应通用字段已省略,详细见响应公共字段:
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
success | Boolean | 是 | 数据是否上传成功 |
token | String | 是 | 数据上传成功的唯一标识 |
响应体示例
{
"code": 200,
"msg": "ok",
"data": {
"success": true,
"token": "5045100d3c80451bbcc848ead630e3e2"
}
}
接入示例代码
开发工具集(SDK)接入
为方便 JAVA 开发者调试和接入API,我们提供了配套的开发工具集(SDK),用于简化API接入流程。SDK中各接口调用方式基本相同,接入方式统一,并提供了一些接口调用过程中常见的异常处理方案。以下介绍了SDK的使用流程,以及使用SDK的简单示例。
- 准备工作
准备步骤详见通用步骤
- 使用方法
该接口的使用方法可参考SDK demo