17370845950

零克查词API怎么对接_接口调用与集成开发教程
零克查词API通过捕获网页请求获取Cookie和URL,构造带Cookie的POST请求检测小红书违规词,支持curl验证与Python自动化调用,并解析JSON返回中的illegal_words提取违规信息。

如果您希望在内容发布前自动检测小红书平台的违规词,零克查词API提供了一种便捷的第三方校验方式。以下是完成该API对接的具体操作路径:

一、获取零克查词API访问凭证

零克查词不通过传统开发者平台发放密钥,而是以网页端服务形式提供轻量级API调用入口,需通过其官方检测页面反向解析请求结构并提取必要参数。

1、使用浏览器打开零克查词官网地址:http://ci.lingke.pro

2、在页面任意位置右键选择“检查”,切换至“Network”标签页,并勾选“Preserve log”。

3、在左侧输入框中粘贴一段测试文字,点击“一键检测”按钮。

4、在Network列表中找到名称为checkapi/check的XHR请求,点击进入Headers面板,复制Request URL完整地址及Request Headers中的Cookie字段值。

二、构造HTTP POST请求体

零克查词API采用表单格式提交文本,无需OAuth或Token认证,但依赖会话Cookie维持状态,因此必须复用上一步捕获的Cookie值才能成功调用。

1、准备待检测文本,确保UTF-8编码且长度不超过页面限制(实测上限约5000字符)。

2、设置请求URL为上一步捕获的Request URL,方法为POST。

3、在请求头中添加Content-Type: application/x-www-form-urlencoded; charset=UTF-8

4、在请求头中添加Cookie字段,其值为上一步复制的完整Cookie字符串。

5、请求体使用text=你的检测文本格式,注意对中文和特殊符号进行URL编码。

三、使用curl命令快速验证接口连通性

该方式适用于调试阶段,无需编写代码即可确认基础通信是否正常,适合终端用户快速验证凭证有效性。

1、打开终端,输入以下格式命令(将[YOUR_COOKIE][YOUR_URL]替换为实际值):

curl -X POST "[YOUR_URL]" -H "Content-Type: application/x-www-form-urlencoded; charset=UTF-8" -H "Cookie: [YOUR_COOKIE]" -d "text=%E4%BD%A0%E5%A5%BD"

2、观察返回结果是否为JSON格式,包含resultillegal_words等字段。

3、若返回403 Forbidden或空响应,说明Cookie已失效,需重新捕获。

四、Python脚本自动化调用示例

适用于集成进内容审核系统,通过requests库复现浏览器行为,保持会话一致性并支持批量处理。

1、安装依赖:执行pip install requests

2、新建lingke_check.py文件,填入如下代码(替换urlcookie_str为实际值):

import requests
url = "https://ci.lingke.pro/api/check"
headers = {
    "Content-Type": "application/x-www-form-urlencoded; charset=UTF-8",
    "Cookie": "your_actual_cookie_here"
}
data = {"text": "测试文案内容"}
response = requests.post(url, headers=headers, data=data)

3、运行脚本,打印response.text查看原始返回内容。

4、使用response.json()解析结构,提取illegal_words列表进行后续逻辑判断。

五、处理响应数据与违规词提取

API返回为标准JSON,字段含义固定,可直接按键名提取关键信息,无需额外文档映射。

1、检查响应状态码是否为200,非200需记录response.status_coderesponse.text用于排查。

2、解析JSON后,读取result字段值:若为true表示无违规词;若为false则存在风险。

3、从illegal_words数组中遍历每个对象,提取word(违规词原文)和type(违规类型,如“广告”“违禁”)。

4、将word字段高亮插入原始文本时,需注意原位置偏移,建议使用startend索引字段(若返回中存在)。