# 文本内容安全识别

调试工具

接口应在服务器端调用，详细说明参见服务端API。

本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载），wx-server-sdk >= 0.4.0

# 接口说明

# 接口英文名

msgSecCheck

# 功能描述

该接口用于检查一段文本是否含有违法违规内容。

# 应用场景

用户个人资料违规文字检测；
媒体新闻类用户发表文章，评论内容检测；
游戏类用户编辑上传的素材(如答题类小游戏用户上传的问题及答案)检测等。

# 注意事项

-1.0 版本接口文档【点击查看】，1.0版本在2021年9月1日停止更新，请尽快更新至2.0

频率限制：单个 appId 调用上限为 4000 次/分钟，2,000,000 次/天。

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/wxa/msg_sec_check?access_token=ACCESS_TOKEN

# 云调用

出入参和HTTPS调用相同，调用方式可查看云调用说明文档
接口方法为: openapi.security.msgSecCheck

# 第三方调用

调用方式以及出入参和HTTPS相同，仅是调用的token不同
该接口所属的权限集id为：18
服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证，该参数为 URL 参数，非 Body 参数。使用access_token或者authorizer_access_token
content	string	是	需检测的文本内容，文本字数的上限为2500字，需使用UTF-8编码
version	number	是	接口版本号，2.0版本为固定值2
scene	number	是	场景枚举值（1 资料；2 评论；3 论坛；4 社交日志）
openid	string	是	用户的openid（用户需在近两小时访问过小程序）
title	string	否	文本标题，需使用UTF-8编码
nickname	string	否	用户昵称，需使用UTF-8编码
signature	string	否	个性签名，该参数仅在资料类场景有效(scene=1)，需使用UTF-8编码

# 返回参数

属性

类型

说明

errcode

number

错误码

errmsg

string

错误信息

detail

array<object>

详细检测结果

属性	类型	说明
strategy	string	策略类型
errcode	number	错误码，仅当该值为0时，该项结果有效
suggest	string	建议，有risky、pass、review三种值
label	number	命中标签枚举值，100 正常；10001 广告；20001 时政；20002 色情；20003 辱骂；20006 违法犯罪；20008 欺诈；20012 低俗；20013 版权；21000 其他
keyword	string	命中的自定义关键词
prob	number	0-100，代表置信度，越高代表越有可能属于当前返回的标签（label）

trace_id

string

唯一请求标识，标记单次请求

result

object

综合结果

	属性	类型	说明
	suggest	string	建议，有risky、pass、review三种值
	label	number	命中标签枚举值，100 正常；10001 广告；20001 时政；20002 色情；20003 辱骂；20006 违法犯罪；20008 欺诈；20012 低俗；20013 版权；21000 其他

# 调用示例

示例说明: HTTPS调用

# 请求数据示例


{
       "openid": "OPENID",
       "scene": 1,
       "version": 2,
       "content":"hello world!"
   }

# 返回数据示例


{
   "errcode": 0,
   "errmsg": "ok",
   "result": {
       "suggest": "risky",
       "label": 20001
   },
   "detail": [
       {
           "strategy": "content_model",
           "errcode": 0,
           "suggest": "risky",
           "label": 20006,
           "prob": 90
       },
       {
           "strategy": "keyword",
           "errcode": 0,
           "suggest": "pass",
           "label": 20006,
           "level": 20,
           "keyword": "命中的关键词1"
       },
       {
           "strategy": "keyword",
           "errcode": 0,
           "suggest": "risky",
           "label": 20006,
           "level": 90,
           "keyword": "命中的关键词2"
       }
   ],
   "trace_id": "60ae120f-371d5872-7941a05b"
}

示例说明: 云函数调用

# 请求数据示例


const cloud = require('wx-server-sdk')
cloud.init({
  env: cloud.DYNAMIC_CURRENT_ENV,
})
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.security.msgSecCheck({
        "openid": 'OPENID',
        "scene": 1,
        "version": 2,
        "content": 'hello world!'
      })
    return result
  } catch (err) {
    return err
  }
}

# 返回数据示例


{
   "errcode": 0,
   "errmsg": "ok",
   "result": {
       "suggest": "risky",
       "label": 20001
   },
   "detail": [
       {
           "strategy": "content_model",
           "errcode": 0,
           "suggest": "risky",
           "label": 20006,
           "prob": 90
       },
       {
           "strategy": "keyword",
           "errcode": 0,
           "suggest": "pass",
           "label": 20006,
           "level": 20,
           "keyword": "命中的关键词1"
       },
       {
           "strategy": "keyword",
           "errcode": 0,
           "suggest": "risky",
           "label": 20006,
           "level": 90,
           "keyword": "命中的关键词2"
       }
   ],
   "trace_id": "60ae120f-371d5872-7941a05b"
}

# 错误码

错误码	错误码取值	解决方案
-1	system error	系统繁忙，此时请开发者稍候再试
40001	invalid credential access_token isinvalid or not latest	access_token 无效或不为最新获取的 access_token，请开发者确认access_token的有效性
40003	invalid openid	不合法的 OpenID ，请开发者确认 OpenID 的有效性
40129	invalid scene	场景值错误（目前支持场景 1 资料；2 评论；3 论坛；4 社交日志）
43104	The openid does not match the appid	appid与 openid 不匹配
43002	require POST method	方法调用错误，请用 post 方法调用
44002	empty post data	POST 的数据包为空。post请求body参数不能为空。
44991	reach max api minute frequence	超出接口每分钟调用限制
45009	reach max api daily quota limit	超出接口每日调用限制
47001	data format error	解析 JSON/XML 内容错误;post 数据中参数缺失;检查修正后重试。
61010	code is expired	用户访问记录超时（用户未在近两小时访问小程序）