敏感词过滤API

API端点

GET https://api.vitphp.cn/textcheck

请求参数

响应格式

API返回JSON格式的数据，包含以下字段：

{
  "code": 1,
  "original": "提交的原始文本",
  "filtered": "过滤后的文本",
  "sensitive_words": [
    {
      "word": "违禁词",
      "type": "违禁类型"
    },
    ...
  ]
}

错误代码

当code字段不为1时，表示请求出错，可能的错误代码如下：

敏感词类型

敏感词类型分类如下：

使用限制

• 免费版每分钟最多可调用10次API
• 每次请求的文本长度不能超过10,000个字符
• 请合理使用API，避免频繁调用
• 敏感词库会定期更新，以保证检测效果

JavaScript示例

async function checkSensitiveText(text) {
    try {
        const encodedText = encodeURIComponent(text);
        const response = await fetch(`https://api.vitphp.cn/textcheck/?text=${encodedText}`);

        if (!response.ok) {
            throw new Error(`HTTP错误: ${response.status}`);
        }

        const data = await response.json();

        if (data.code === 1) {
            console.log("原始文本:", data.original);
            console.log("过滤后文本:", data.filtered);
            console.log("检测到的敏感词:");
            data.sensitive_words.forEach(word => {
                console.log(`- ${word.word} (${word.type})`);
            });
            return data;
        } else {
            console.error("请求错误:", data.message);
            return null;
        }
    } catch (error) {
        console.error("发生异常:", error);
        return null;
    }
}

// 使用示例
const text = "这是一段包含敏感词的测试文本，例如傻逼和操你妈等词汇应该被过滤。";
checkSensitiveText(text).then(result => {
    // 处理结果
});

PHP示例

function checkSensitiveText($text) {
    $url = "https://api.vitphp.cn/textcheck";
    $params = [
        "text" => $text
    ];

    $urlWithParams = $url . '?' . http_build_query($params);

    $ch = curl_init($urlWithParams);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

    $response = curl_exec($ch);

    if (curl_errno($ch)) {
        echo 'Curl错误: ' . curl_error($ch);
        return null;
    }

    curl_close($ch);

    $data = json_decode($response, true);

    if ($data["code"] == 1) {
        echo "原始文本: " . $data["original"] . "\n";
        echo "过滤后文本: " . $data["filtered"] . "\n";
        echo "检测到的敏感词:\n";
        foreach ($data["sensitive_words"] as $word) {
            echo "- " . $word["word"] . " (" . $word["type"] . ")\n";
        }
        return $data;
    } else {
        echo "请求错误: " . $data["message"] . "\n";
        return null;
    }
}

// 使用示例
$text = "这是一段包含敏感词的测试文本，例如傻逼和操你妈等词汇应该被过滤。";
$result = checkSensitiveText($text);

Java示例

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;

public class SensitiveTextChecker {
    public static void main(String[] args) {
        String text = "这是一段包含敏感词的测试文本，例如傻逼和操你妈等词汇应该被过滤。";
        checkSensitiveText(text);
    }

    public static void checkSensitiveText(String text) {
        try {
            String encodedText = URLEncoder.encode(text, StandardCharsets.UTF_8);
            URL url = new URL("https://api.vitphp.cn/textcheck/?text=" + encodedText);
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            connection.setRequestMethod("GET");

            int responseCode = connection.getResponseCode();
            if (responseCode == HttpURLConnection.HTTP_OK) {
                BufferedReader reader = new BufferedReader(
                    new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF_8));
                StringBuilder response = new StringBuilder();
                String line;

                while ((line = reader.readLine()) != null) {
                    response.append(line);
                }
                reader.close();

                // 解析JSON响应
                String jsonResponse = response.toString();
                // 这里可以使用JSON解析库如Jackson或Gson来解析响应
                System.out.println("API响应: " + jsonResponse);
            } else {
                System.out.println("HTTP错误: " + responseCode);
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

cURL示例

# 示例文本
text="这是一段包含敏感词的测试文本，例如傻逼和操你妈等词汇应该被过滤。"

# 编码文本
encodedText=$(echo "$text" | sed 's/ /%20/g' | sed 's/"/%22/g' | sed 's/&/%26/g' | sed 's//%3E/g')

# 发送请求
curl "https://api.vitphp.cn/textcheck/?text=$encodedText"

API的响应时间是多久？

在正常情况下，API的响应时间通常在100-300毫秒之间，具体取决于文本长度和服务器负载情况。

敏感词库多久更新一次？

我们的敏感词库每周更新一次，以确保能够检测到最新出现的敏感词汇。如遇特殊情况，我们会加快更新频率。

如何添加自定义敏感词？

目前免费版不支持添加自定义敏感词。企业版用户可以通过控制台添加和管理自定义敏感词库，如需了解更多，请联系我们的销售团队。

API有调用频率限制吗？

免费版API每分钟最多可调用10次。如需更高的调用频率限制，可以升级到我们的付费套餐或联系我们申请企业版API密钥。

支持哪些语言的敏感词检测？

目前敏感词过滤API主要支持中文敏感词检测。英文和其他语言的支持正在开发中，敬请期待。

如何处理API返回的错误？

当API返回错误时，您可以根据返回的错误代码和消息进行相应的处理。建议在调用API时添加适当的错误处理逻辑，以提高应用的健壮性。