风险画像数据上报接口

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

    在线咨询 电话咨询:95163223 免费试用