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" 内容正常
"其他提示" 错误信息