零克查词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列表中找到名称为check或api/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格式，包含result、illegal_words等字段。
3、若返回403 Forbidden或空响应，说明Cookie已失效，需重新捕获。
四、Python脚本自动化调用示例
适用于集成进内容审核系统，通过requests库复现浏览器行为，保持会话一致性并支持批量处理。
1、安装依赖：执行pip install requests。
2、新建lingke_check.py文件，填入如下代码（替换url和cookie_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_code和response.text用于排查。
2、解析JSON后，读取result字段值：若为true表示无违规词；若为false则存在风险。
3、从illegal_words数组中遍历每个对象，提取word（违规词原文）和type（违规类型，如“广告”“违禁”）。
4、将word字段高亮插入原始文本时，需注意原位置偏移，建议使用start与end索引字段（若返回中存在）。
