微信小程序内容安全检测接口使用指南

发布时间：2025-11-14 热度：

接口概述

微信小程序提供了内容安全检测API（wxa/msg_sec_check），用于帮助开发者检测用户输入的文本内容是否违规。该接口能够识别包括但不限于政治敏感、色情、暴力、违法等多类违规内容，是小程序内容安全的重要保障。

接口基本信息

接口地址：https://api.weixin.qq.com/wxa/msg_sec_check?access_token=ACCESS_TOKEN
请求方式：POST
数据格式：JSON

使用步骤

1. 获取Access Token

在调用内容安全检测接口前，需要先获取小程序的Access Token：

// 获取access_token的示例代码
const getAccessToken = async () => {
  const appid = '你的小程序AppID';
  const secret = '你的小程序AppSecret';
  
  const response = await fetch(`https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=${appid}&secret=${secret}`);
  const data = await response.json();
  
  if (data.access_token) {
    return data.access_token;
  } else {
    throw new Error(`获取access_token失败: ${data.errmsg}`);
  }
};

2. 调用内容安全检测接口

// 内容安全检测函数
const checkContentSafety = async (content) => {
  try {
    const accessToken = await getAccessToken();
    
    const response = await fetch(`https://api.weixin.qq.com/wxa/msg_sec_check?access_token=${accessToken}`, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        content: content
      })
    });
    
    const result = await response.json();
    
    // 处理返回结果
    if (result.errcode === 0) {
      return { isSafe: true, message: '内容安全' };
    } else if (result.errcode === 87014) {
      return { isSafe: false, message: '内容含有违法违规信息' };
    } else {
      return { isSafe: false, message: `检测失败: ${result.errmsg}` };
    }
  } catch (error) {
    return { isSafe: false, message: `请求异常: ${error.message}` };
  }
};

3. 前端集成示例

在实际应用中，可以将内容安全检测集成到表单提交流程中：

// 表单提交处理
const handleSubmit = async (event) => {
  event.preventDefault();
  
  const content = document.getElementById('userInput').value;
  
  // 显示检测中状态
  showLoadingState();
  
  // 调用安全检测
  const safetyResult = await checkContentSafety(content);
  
  if (safetyResult.isSafe) {
    // 内容安全，继续提交
    submitForm(content);
  } else {
    // 内容违规，提示用户
    showErrorMessage(safetyResult.message);
  }
};


// 绑定提交事件
document.getElementById('submitBtn').addEventListener('click', handleSubmit);

返回码说明

0: 内容正常
87014: 内容含有违法违规信息
其他错误码: 参考微信官方文档中的错误码说明

注意事项

内容长度限制：单次检测的文本内容长度不超过256KB
频率限制：接口有调用频率限制，具体以微信官方文档为准
缓存策略：Access Token有效期为2小时，需要合理缓存和刷新
降级策略：在网络异常或接口不可用时，应有相应的降级处理方案

实际应用场景

场景一：用户评论检测

// 评论提交前的检测
const checkComment = async (commentText) => {
  const safetyCheck = await checkContentSafety(commentText);
  
  if (!safetyCheck.isSafe) {
    alert('您的评论包含违规内容，请修改后重新提交');
    return false;
  }
  
  return true;
};

场景二：用户昵称检测

// 用户修改昵称时的检测
const checkNickname = async (nickname) => {
  if (nickname.length < 2 || nickname.length > 20) {
    return { valid: false, message: '昵称长度应在2-20个字符之间' };
  }
  
  const safetyCheck = await checkContentSafety(nickname);
  
  if (!safetyCheck.isSafe) {
    return { valid: false, message: '昵称包含违规内容' };
  }
  
  return { valid: true, message: '昵称可用' };
};