# 文本检测接口
## 接口地址
[https://api.jinyongci.com/openapi/search/searchtext](https://api.jinyongci.com/openapi/search/searchtext)
## 接口描述
POST请求, 接受 application/x-www-form-urlencoded 和form-data编码格式。
每个ip每分钟600个请求。
>[warning] 文本限制
>单次请求 < 1万字符,字段长度超过1万字符,会截取前面1万字符进行检测;最长不超过15000个字符,
否则会报1000错误(参数错误,检查后重试)
## 请求参数
公共参数已省略,详细见[请求公共参数](https://www.kancloud.cn/nuoers/occ-jyc-openapi/2232514),其他参数如下:
### 基本参数
| 参数名称 | 类型 | 是否必选 | 最大长度 | 描述 |
| --- | --- | --- | --- | --- |
| text| String | Y | 15000 | 用户检查内容,建议对内容中JSON、表情符、HTML标签、UBB标签、+、- 符号等做过滤,只传递纯文本,以减少误判概率 |
| business_ids| String | Y | 512 | 行业分类,您可指定多个行业类别进行检测(**不可超过2个行业,且必须包含通用词库**),多个行业类别以逗号分隔("100,200"),行业分类列表:1:通用词库,2:电脑数码,3:家用电器,4:运动户外,5:服饰鞋包,6:美妆个护,7:母婴用品,8:日用百货,9:食品保健,10:办公设备,11:家居家装,12:汽车用品,13:旅游出行,14:文化娱乐,15:厨房餐饮,16:图书音像,17:五金电子,18:礼品钟表,19:玩模乐器,20:房产置业,21:医药计生,22:金融服务 |
| exclude_level| String | N | 512 | 排除违禁词的等级。不传默认查询所有等级,禁用多个时使用逗号分隔("1,2")等级列表:1:一级(提示注意型词汇)2:二级(提示性词汇,如,成分,功效,商标,野生动植物等 (但不代表无风险,如:2020-2021长江禁捕野生鱼类,被投诉的少,但处罚的严重))3:三级(有夸大嫌疑、夸大承诺但投诉收录量较少,低于50例的,电商平台或商家反馈部分可以申诉成功案例的)4:四级(投诉案例50例以上、明显需要严格证明的、非本行业乱用专用术语的、严重夸大虚假宣传的)5:五级(极端敏感词、电商平台禁售商品、违反法律法规可能会引起犯罪的、投诉案例100例以上的) |
## 响应结果
响应字段如下,响应通用字段已省略,详细见[响应通用字段](https://www.kancloud.cn/nuoers/occ-jyc-openapi/2232513):
data数据结构
| 参数名称 | 类型 | 描述 |
| --- | --- | --- |
| text | String | 查询内容 |
| word_list| json数组 | 违禁词数组 |
word_list数据结构
| 参数名称 | 类型 | 描述 |
| --- | --- | --- |
| word| String | 禁用词 |
| remark| String | 禁用词说明 |
| level| level | 禁用词等级(说明见基本参数中exclude_level中描述部分) |
## 响应示例
结果为不通过时,输出示例如下:
~~~json
{
"code": 2004,
"message": "当前请求已过期或时间戳格式不正确",
"data": null
}
~~~
结果为通过时,输出示例如下:
~~~json
{
"code": 200,
"message": "ok",
"data": {
"text": "0第一",
"word_list": [{
"word": "第一",
"remark": "虚假夸大、贬低竞品,使用极限用语或谐音夸大宣称产品特性功效或原料的情况;以不具有,不包含,强调无某特性等作为宣传点。使消费者认为该产品优于竞品的情况。注:步骤、次序、时间描述类,如第一步,第一类等,第一个小时等,不列入风险词。",
"level": 5
}]
}
}
~~~