# security.msgSecCheck-v1
本接口应在服务器端调用,详细说明参见服务端API。
本接口支持云调用。需开发者工具版本 >=
1.02.1904090
(最新稳定版下载),wx-server-sdk
>=0.4.0
检查一段文本是否含有违法违规内容。
应用场景举例:
- 用户个人资料违规文字检测;
- 媒体新闻类用户发表文章,评论内容检测;
- 游戏类用户编辑上传的素材(如答题类小游戏用户上传的问题及答案)检测等。 频率限制:单个 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" | 内容正常 | |
"其他提示" | 错误信息 |