用户信息类API
|
接口分类 |
接口功能说明 |
接口详细文档 |
|
后台接口 |
获取用户信息 |
/v3/user/filter_dirty_words |
/v3/user/filter_dirty_words
1 功能说明
验证文本是否包含敏感词，如果包含则将过滤敏感词后的文本以及敏感词放入结果列表。
2 URL
//[域名/IP]/v3/user/filter_dirty_words
正式环境下使用域名：openapi.minigame.qq.com
URL参数详见：API3.0文档#请求URL说明。
3 格式
JSON
4 HTTP请求方式
GET
5 IP限制
TRUE
6 输入参数说明
各个参数请进行URL 编码，编码时请遵守 RFC 1738
（1）公共参数
发送请求时必须传入公共参数，详见公共参数说明。
（2）私有参数
|
参数名称 |
类型 |
参数含义 |
可选/必选 |
|
account_ |
string |
帐号：QQ或Openid |
必选 |
|
plat_id_ |
int |
平台 id：ios:0, android:1，pc:2 |
必选 |
|
world_ |
int |
大区 |
必选 |
|
cmd_ |
int |
文本业务：2 |
必选 |
|
callback_data_ |
int |
回带字段 |
必选 |
|
err_code_ |
int |
错误码 |
可选 |
|
err_msg_ |
string |
错误原因描述 |
可选 |
|
text_category_ |
int |
文本分类：角色名：1，用户签名：2，用户 描述：3，用户发言：4，标题：5，评论：6， 文章：7 |
必选 |
|
text_ |
string |
文本数据 |
必选 |
|
get_sens_words |
int |
是否需要返回命中的敏感词 |
必选 |
|
charset |
string |
url编码格式：utf8或gbk |
可选，默认为utf8 |
7 请求示例
正式环境：//openapi.minigame.qq.com/v3/user/filter_dirty_words?openid=299BA98634628BAA441603815A3B0E20&openkey=3B459B25D3E2C594DDA6C923B6821F3C&pf=qqgame&appid=100700930&account_=&plat_id_=0&world_=0&cmd_=2&callback_data_=&err_code_=0&err_msg_=&text_category_=1&text_=abcdefuckfgh%E6%B1%9F%E6%B3%BD%E6%B0%91&get_sens_words_=1&charset=utf8&sig=9SzVC3TW07bjkOYVZfDMSc7PLZ0%3D
沙箱环境(不用填openid、openkey以及sig)：//dir.minigame.qq.com/qqgame/user/filter_dirty_words?pf=qqgame&appid=100700930&account_=&plat_id_=0&world_=0&cmd_=2&callback_data_=&err_code_=0&err_msg_=&text_category_=1&text_=abcdefuckfgh%25E6%25B1%259F%25E6%25B3%25BD%25E6%25B0%2591&get_sens_words_=1&charset=utf8
8 返回参数说明
|
参数名称 |
类型 |
含义 |
|
ret |
int |
详见公共返回码 |
|
msg |
string |
错误描述 |
|
msg_ |
string |
过滤后的消息，敏感词将会替换成“*” |
|
dirty_flag_ |
int |
0：正常，2：恶意 |
|
dirty_cnt_ |
int |
命中的敏感词个数 |
|
dirty_words_ |
string数组 |
敏感词列表 |
9 正确返回示例
JSON示例:
{
"ret":0,
"msg":"",
"uin":0,
"msg_":"abcde****fgh***",
"dirty_flag_":2,
"dirty_cnt_":2,
"dirty_words_":["fuck","江泽民"],
"seq":0,
"pf":""
}
10 错误返回示例
参见公共错误返回示例