风险画像数据上报接口
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
