阿里云文本关键词过滤检测

功能描述

关键词检测是对文本检测的最简单的一种方式，本文章对一段文本进行关键词的匹配，判断是否包含特定关键词。​

HTTP 接口描述

场景(scene)中文名	场景（scene）	分类（label）	备注
关键词检测	keyword	normal	正常文本
关键词检测	keyword	spam	含违规信息
关键词检测	keyword	ad	广告
关键词检测	keyword	politics	渉政
关键词检测	keyword	terrorism	暴恐
关键词检测	keyword	porn	色情
关键词检测	keyword	contraband	违禁
关键词检测	keyword	customized	自定义(比如命中自定义关键词)

​​​​

1.2 文本关键词检测 (uri: /green/text/scan)

检测文本是否为命中特定关键词。请求body是一个结构体，说明如下：​

字段	类型	是否必须	说明
bizType	字符串	可选	业务类型，调用方从绿网申请所得。每个bizType对应不同的算法/模型。根据配置，后端可根据该字段对请求做不同处理。属于高级用法
scenes	字符串数组	必须	字符串数组，场景定义参考1.1小节；关键词检测，scenes请填写keyword
tasks	JSON数组	必须	文本检测任务列表；每个元素是个结构体，最多支持100个，即100段文本的检测.参见下表。

JSON数组中的每个元素是一个结构体，有如下字段：

字段	类型	是否必须	说明
clientInfo	JSON结构体	可选	客户端信息，参考[调用方式/公共请求参数/公共查询参数]小节中ClientInfo结构体描述。服务器会把[调用方式/公共请求参数/公共查询参数]小节中全局的clientInfo和这里的独立的clientInfo合并。独立的clientInfo优先级更高。
dataId	字符串	可选	调用者通常保证一次请求中，所有的dataId不重复
content	字符串	必须	待检测文本
time	整形	可选	内容创建/编辑时间，单位ms
category	字符串	可选	内容类别，取值范围为[“post”, “reply”, “comment”, “title”, “others”]；也可以自定义的其他类型，但长度不超过64字节
action	字符串	可选	操作类型，取值范围为[“new”, “edit”, “share”, “others”]；也可以自定义的其他操作类型，但长度不超过64字节
relatedDataId	字符串	可选	相关dataId；当contentType为reply或comment时，该字段设置相关的主贴或对应的comment的dataId
relatedContent	字符串	可选	相关字符串；当contentType为reply或comment时，该字段设置为主贴内容或对应的comment

返回body中的Data字段是JSON数组，每一个元素有如下字段：

字段	类型	是否必须	说明
code	整形	必须	错误码，和http的status code一致
msg	字符串	必须	错误描述信息
dataId	字符串	可选	对应的请求中的dataId
taskId	字符串	必须	绿网服务器返回的唯一标识该检测任务的ID
content	字符串	可选	对应的请求中的content
results	数组	可选	当成功时（code == 200）,该结果的包含一个或多个元素。每个元素是个结构体。参见下表。

上表results中包含的元素说明：

字段	类型	是否必须	说明
scene	字符串	必须	风险场景
suggestion	字符串	必须	建议用户处理，取值范围：[“pass”, “review”, “block”], pass:文本正常，review：需要人工审核，block：文本违规，可以直接删除或者做限制处理
label	字符串	必须	该文本的分类，取值范围参考1.1小节
rate	浮点数	必须	结果为该分类的概率；值越高，越趋于该分类；取值为[0.00-100.00], 分值仅供参考，您只需要关注label和suggestion的取值即可
extras	JSON对象	可选	附加信息，命中的上下文.该值将来可能会调整，建议不要在业务上进行依赖

各语言SDK依赖开发环境准备

请参照 https://develop.aliyun.com/sdk/java?spm=5176.doc28430.2.1.Qp3LL4 准备阿里云SDK依赖环境, 进行开发.

添加依赖包 maven
内容检测API SDK包含阿里云Java SDK公共部分和内容检测部分，公共部分依赖 aliyun-java-sdk-core , 内容检测部分依赖 aliyun-java-sdk-green