v3/csec/check_spam

特别声明:
本接口调用前需申请权限,申请条件及说明详见下文第3节说明。

目录

1 功能说明

垃圾消息检测服务主要是针对webgame类型应用中出现的虚假广告、外挂宣传、私服宣传、工作室代练和线下交易信息、竞品宣传、恶意刷屏等垃圾信息和发言行为进行检测。
系统会对应用上报的数据进行建模,从文字识别、用户行为分析、信用度体系等各个维度识别垃圾消息,并将检测结果通过本接口返回给应,然后由开发方自行处理,如丢弃、警告、禁言等。
垃圾消息检测服务的目的是为了抑制游戏内垃圾消息的传播,净化游戏中的言论环境,提高玩家的游戏体验。

调用本接口后,将会检查应用中用户的发言、邮件、群组名等信息,对垃圾信息(例如广告、脏话)进行识别。
如果包含有垃圾信息,则给出建议的禁言时长,应用可自行进行相应的处理。

备注:
本接口和敏感词过滤接口(v3/csec/word_filter)的不同:
(1) 场景不同,本接口主要是针对广告、脏话等垃圾信息;敏感词过滤接口主要针对涉及到政治、黄赌毒等的敏感词。
(2) 处理方式不同,本接口返回的是该信息是否包含垃圾信息,以及对于发表垃圾信息的用户给出建议的禁言时长,具体如何处理由应用自行决定;敏感词过滤接口则会对敏感词直接用*覆盖,或者返回“文本中有敏感词”的消息。
对于用户的发言、邮件、群组名等信息,应用既要保证信息中不含敏感词,可能也需要检测是否包含垃圾信息,因此对于同1个信息,这2个接口有可能都要被用到。

2 接口调用说明

2.1 URL

http://[域名]/v3/csec/check_spam

正式环境域名或测试环境IP详见:API3.0文档#请求URL说明

2.2 格式

json,xml

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数

参数名称 是否必须 类型 描述
ctype 必须 string 表示用户信息输入的途径。

1:表示聊天;
2:表示邮件;
3:表示游戏中的角色名;
4:表示其他类型,如sns游戏中的留言板等。

content 必须 string 待检查是否存在垃圾信息的文本。


2.6 请求示例

http://113.108.20.23/v3/csec/check_spam?
openid=95AACD773728BAD2E594B69C11B260EE&
openkey=265B6E683A897FA4F7F5923614CBDF53&
appid=100624434&
sig=6g%2Fo89i5Jwoc2psm7SODXoSC1t8%3D&
pf=qzone&
format=json&
ctype=1
content=hello

2.7 返回参数说明

参数名称 描述
ret 返回码。详见公共返回码说明#OpenAPI V3.0返回码
msg 如果错误,返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。

0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。

result 标识用户输入的信息是否有恶意信息(0:正常; 1:有恶意信息)。
forbidden_time 0:表示用户输入的信息中没有恶意信息,不用进行任何处理;

大于0:表示用户输入的信息中含有恶意信息,建议对该用户禁言,数值表示建议的禁言时长,以秒为单位。

2.8 正确返回示例

JSON示例:

Content-Type: text/html;charset=utf-8
{
"ret": 0,
"is_lost": 0,
"result": 0,
"forbid_time": 0
}


XML示例:

<?xml version="1.0" encoding="UTF-8"?> 
<data>
   <ret>0</ret>
   <is_lost>0</is_lost>
   <result>0</result>
   <forbid_time>0</forbid_time>
</data>

2.9 错误返回示例

Content-Type: text/html; charset=utf-8
{
"ret":1002,
"msg":"请先登录"
}

3. 接口权限申请说明

3.1 申请条件

为了使资源利用价值最大化,只有符合条件的应用才能通过审批获得接口权限。
请开发者自我衡量游戏当前垃圾消息泛滥程度,然后提交申请。

申请条件如下:
1. 游戏目前垃圾消息泛滥,严重影响正常玩家发言。
2. 游戏的在线和活跃用户数在开放平台游戏总体排名中越靠前,或者开发者星级越高,接入优先级越高。
3. 游戏成长速度排名越靠前,接入优先级越高。

3.2 申请方式及流程

Step1. 开发者自我衡量游戏当前垃圾消息泛滥程度,并且收集相关证据(例如截图)。
Step2. 按照以下邮件模板发送申请邮件:

收件人:stevzhou@tencent.com
邮件主题:【垃圾消息检测服务接入申请】:APPID+游戏中文名称
邮件正文:
【APPID】:
【游戏中文名称】:
【申请人QQ】:
【目前游戏垃圾消息情况自评】:
【垃圾消息举例】:游戏内垃圾消息截图(可以以附件形式给出)


Step3. 腾讯方进行审批,审批在1-5个工作日内完成(因为需要和开发者交互沟通,并且试玩游戏和查看垃圾消息情况,需要一定的时间,我们将尽最大努力尽快完成审批)。

3.3 总体开发流程

Step1. 审批通过后,开发者在应用中调用统一数据接入API接口(接口说明文档及SDK详见:统一数据接入)将应用的日志数据上报,作为垃圾消息检测模型的数据来源,日志格式、字段内容腾讯方会在审批通过后的回复邮件中给出。
Step2. 数据上报完成后,腾讯方需要1周时间配置检测模型。
Step3. 开发者调用垃圾消息检测本接口(v3/csec/check_spam)对游戏中的发言进行垃圾消息检测,该接口将返回检测结果和建议禁言时长。
Step4. 开发者根据接口返回结果,对消息内容和发消息的玩家进行相应处理。

以上信息是否解决您的问题?

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部