# security.msgSecCheck-v1

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

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

检查一段文本是否含有违法违规内容。

应用场景举例:

  1. 用户个人资料违规文字检测;
  2. 媒体新闻类用户发表文章,评论内容检测;
  3. 游戏类用户编辑上传的素材(如答题类小游戏用户上传的问题及答案)检测等。 频率限制:单个 appId 调用上限为 4000 次/分钟,2,000,000 次/天*

调用方式:

# HTTPS 调用

# 请求地址

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

# 请求参数

属性 类型 默认值 必填 说明
access_token / cloudbase_access_token string 接口调用凭证
content string 要检测的文本内容,长度不超过 500KB

# 返回值

# Object

返回的 JSON 数据包

属性 类型 说明
errcode number 错误码
errmsg string 错误信息
trace_id string 唯一请求标识,标记单次请求
result object 综合结果
detail array 详细检测结果

errcode 的合法值

说明 最低版本
0 内容正常
-1 系统繁忙,此时请开发者稍候再试
40001 token 无效
40003 openid无效
40129 场景值错误(目前支持场景 1 资料;2 评论;3 论坛;4 社交日志)
43104 appid与openid不匹配
43302 方法调用错误,请用post方法调用
44002 传递的参数为空
47001 传递的参数格式不对
61010 用户访问记录超时(用户未在近两小时访问小程序)
其他 系统错误

errmsg 的合法值

说明 最低版本
"ok" 内容正常
"其他提示" 错误信息

# 调用示例

curl -d '{ "content":"hello world!" }' 'https://api.weixin.qq.com/wxa/msg_sec_check?access_token=ACCESS_TOKEN'

# 测试用例

特3456书yuuo莞6543李zxcz蒜7782法fgnv级
完2347全dfji试3726测asad感3847知qwez到

开发者可使用以上两段文本进行测试,若接口errcode返回87014(内容含有违法违规内容),则对接成功。

调用过程中如遇到问题,可在官方社区发帖交流。

# 云调用

云调用是微信云开发提供的在云函数中调用微信开放接口的能力,需要在云函数中通过 wx-server-sdk 使用。

# 接口方法

openapi.security.msgSecCheck-v1

需在 config.json 中配置 security.msgSecCheck-v1 API 的权限,详情

# 请求参数

属性 类型 默认值 必填 说明
content string 要检测的文本内容,长度不超过 500KB

# 返回值

# Object

返回的 JSON 数据包

属性 类型 说明
errCode number 错误码
errMsg string 错误信息
traceId string 唯一请求标识,标记单次请求
result object 综合结果
detail array 详细检测结果

errCode 的合法值

说明 最低版本
0 成功

# 异常

# Object

抛出的异常

属性 类型 说明
errCode number 错误码
errMsg string 错误信息

errCode 的合法值

说明 最低版本
-1 系统繁忙,此时请开发者稍候再试
40001 token 无效
40003 openid无效
40129 场景值错误(目前支持场景 1 资料;2 评论;3 论坛;4 社交日志)
43104 appid与openid不匹配
43302 方法调用错误,请用post方法调用
44002 传递的参数为空
47001 传递的参数格式不对
61010 用户访问记录超时(用户未在近两小时访问小程序)
其他 系统错误

errMsg 的合法值

说明 最低版本
"ok" 内容正常
"其他提示" 错误信息