文本提交接口

接口地址

http://as.dun.163.com/v3/text/check

接口描述

根据发布的内容、发布者、ip、设备id等信息来检测是否为需拦截内容。接口同步返回易盾内容安全服务实时反垃圾引擎检测结果,产品可以根据该结果对数据进行初步过滤。该接口返回结果状态分以下三种:

  • 不通过:表示是确认内容非法,产品可对数据做删除隐藏处理。
  • 嫌疑:表示该内容疑似非法,需内容安全云服务离线检测模块进一步确认处理,确认结果需产品自行定期调用文本离线检测结果获取获取,产品对嫌疑数据可以做特殊策略处理,如本人可见等。
  • 通过:表示云安全反垃圾云服务实时反垃圾引擎未识别为非法内容,产品对该类数据可以直接放过,发表成功。云安全反垃圾云服务离线检测模块也会对这些数据做进一步分析处理,分析结果需产品自行定期调用文本离线检测结果获取获取。

文本限制

单次请求<5000字符,字段长度超过5000字符,会截取前面5000字符进行检测和存储;

请求参数

公共参数已省略,详细见 请求公共参数,其他参数如下:

基本参数

参数名称类型是否必选最大长度描述
dataIdStringY128数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
contentStringY5000用户发表内容,建议对内容中JSON、表情符、HTML标签、UBB标签等做过滤,只传递纯文本,以减少误判概率
titleStringN512内容标题,适用于贴子、博客的文章标题等场景,建议抄送,辅助机审策略精准调优
dataTypeNumberN4子数据类型,与易盾内容安全服务约定即可
versionStringY4接口版本号,可选值 v3.1
callbackStringN2^16-1数据回调参数,调用方根据业务情况自行设计,当调用文本离线结果获取接口时,该接口会原样返回该字段,详细见文本离线检测结果获取。作为数据处理标识,因此该字段应该设计为能唯一定位到该次请求的数据结构,如对用户的昵称进行检测,dataId可设为用户标识(用户ID),用户修改多次,每次请求数据的dataId可能一致,但是callback参数可以设计成定位该次请求的数据结构,比如callback字段设计成json,包含dataId和请求的时间戳等信息,当然如果不想做区分,也可以直接把callback设置成dataId的值。
publishTimeNumberN13发表时间,UNIX 时间戳(毫秒值)
callbackUrlStringN256人工审核结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。
checkLabelsStringN512业务过检分类,如果没有勾选分类提交返回参数错误,您可指定多个垃圾类别进行机器检测,多个垃圾类别以逗号分隔("100,200"),指定后业务配置过检分类即失效,过检分类列表:100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水

业务扩展参数

业务扩展参数,有助于通过业务维度辅助反垃圾结果判定

参数名称类型是否必选最大长度描述
ipStringN128用户IP地址,建议抄送,辅助机审策略精准调优
accountStringN128用户唯一标识,建议抄送,辅助机审策略精准调优如果无需登录则为空
nicknameStringN128用户昵称,建议抄送,辅助机审策略精准调优
deviceTypeNumberN4用户设备类型,1:web, 2:wap, 3:android, 4:iphone, 5:ipad, 6:pc, 7:wp ,建议抄送,辅助机审策略精准调优
deviceIdStringN128用户设备 id ,建议抄送,辅助机审策略精准调优
relatedKeysStringN512String数组,多个关联Key以逗号分隔("xxx,xxx"),最多三个Key,单个Key长度不超过128,适用于私聊/评论/跟帖等情况同一用户或不同用户发送多条违规内容关联检测的场景。如需要检测同一评论下的同一用户或不同用户发送违规内容盖楼场景,Key传值方式可以为("评论ID用户ID,评论ID")
extStr1StringN128自定义扩展参数
extStr2StringN128自定义扩展参数
extLon1LongN2^63-1自定义扩展参数
extLon1LongN2^63-1自定义扩展参数

响应结果

响应字段如下,响应通用字段已省略,详细见响应通用字段

result 数据结构

参数名称类型描述
actionNumber检测结果,0:通过,1:嫌疑,2:不通过
censorTypeNumber审核模式,0:纯机审,1:机审+部分人审,2:机审+全量人审
strategyVersionString策略版本号,策略更新时该参数会更新,可用于追溯策略调优效果
taskIdString本次请求数据标识,可以根据该标识查询数据最新结果
labelsjson数组分类信息

labels 数据结构

参数名称类型描述
labelNumber分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,900:其他
subLabelsjson数组细分类信息,可能包含多个,可能为空
levelNumber分类级别,0:通过, 1:嫌疑,2:不通过
detailsjson对象其他信息

subLabels 数据结构

参数名称类型描述
subLabelNumber细分类,详细编码请参考下方对应细分类编码对应表

自定义细分类

易盾支持subLabel自定义细分类过检并返回,如有需求,可联系您的专属安全策略经理添加。

details 数据结构

参数名称类型描述
hintjson数组线索信息,用于定位文本中有问题的部分,辅助人工审核
hitInfosjson数组线索详细信息

hitInfos 数据结构

参数名称类型描述
hitTypeNumber线索分类信息,返回10:表示命中用户自定义添加用户名单,返回11:表示命中用户自定义添加ip名单,返回30:表示命中用户自定义添加敏感词,返回140:标识命中反作弊(hitReason为反作弊命中原因,1:数据异常 2:行为模型 3:设备模型 4:业务类型 5:校验异常 6:模拟器 7:越狱或root 8:浏览器异常 9:ip异常 10:易盾黑名单 11:自定义黑名单 12:自定义白名单)

响应示例

结果为不通过时,输出示例如下:

{
  "code": 200,
  "msg": "ok",
  "result": {
    "taskId": "fx6sxdcd89fvbvg4967b4787d78a",
    "action": 1,
    "censorType": 0,
    "labels": [
      {
        "label": 100,
        "level": 1,
        "details": {
          "hint": [
            "xxx,ooo"
          ],
          "hitInfos": []
        },
        "subLabels": [
          {
            "subLabel": "100002"
          }
        ]
      }
    ]
  }
}

结果为通过时,输出示例如下:

{
    "code": 200,
    "msg": "ok",
    "result": {
        "taskId": "079560a6c9f34783bdce47e168510038",
        "action": 0,
        "labels": [
            
        ]
    }
}