v3/csec/punish_query

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

目录

1 功能说明

对于接入反外挂系统的游戏,反外挂系统会对外挂用户进行封号等打击策略,但是部分游戏需要对外挂用户进行更深入的打击,例如禁言等。
本接口主要用来查询游戏是否需要对某个用户进行深入的反外挂打击,打击的类型目前包括限制登录、禁言,类型后续会扩展。
游戏查询到需要对用户进行深入打击后,需要自行在游戏内实施打击策略。

2 接口调用说明

2.1 URL

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

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

2.2 格式

json,xml

2.3 HTTP请求方式

GET

2.4 IP限制

TRUE

2.5 输入参数说明

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

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

(2)私有参数

参数名称 是否必须 类型 描述
type 必须 unsigned int 打击策略的类型。

1表示限制登录,2表示禁止发言,如果需要增加新的打击策略类型,请在申请本接口权限时提交。

2.6 请求示例

http://113.108.20.23/v3/csec/punish_query? openid=E5B46185F0F28A4B76D4A70DD0F5B999&openkey=6CF84D282DF3D7BC8ECCC421427F9999&pf=qzone&appid=100642969& format=json&userip=10.0.0.1&type=2&sig=Zcsw8JC4Ibf9gIspubJ5t4VUlmc%3D

2.7 返回参数说明

参数名称 描述
ret 返回码。详见公共返回码说明#OpenAPI V3.0返回码
punish 是否需要进行深入打击。

0表示游戏不需要对这个用户进行深入打击。
1表示游戏需要对这个用户进行深入打击,打击策略即请求中传入的type值,深入打击策略的实施由游戏自己进行。

2.8 正确返回示例

JSON示例:

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


XML示例:

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

2.9 错误返回示例

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

3. 接口权限申请说明

3.1 申请条件

为了使资源利用价值最大化,只有符合条件的应用才能通过审批获得接口权限。

申请条件如下:
1. 游戏已经接入了腾讯反外挂系统(详见:反外挂接入说明)。
2. 游戏目前外挂形势严峻,或者外挂对游戏潜在威胁较大,反外挂系统提供的打击力度不能满足需求,需要进行进一步的深入打击。
3. 游戏的在线和活跃用户数在开放平台游戏总体排名中越靠前,或者开发商星级越高,接入优先级越高。
4. 游戏成长速度排名越靠前,接入优先级越高。

3.2 申请方式及流程

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

收件人:bryanjzhang@tencent.com
邮件主题:【/v3/csec/punish_query接口权限申请】:APPID+游戏中文名称
邮件正文:
【APPID】:
【游戏中文名称】:
【需要进行的打击策略类型】:如果系统提供的打击策略(见2.5节中参数typ的值)不能满足需求,请填写新的打击策略类型
【申请人QQ】:
【目前游戏外挂情况自评】:
【是否有外挂样本】:(如果有,请给出外挂的名称)


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

3.3 总体开发流程

Step1. 审批通过后,腾讯分配接口权限。如果申请了新的打击策略类型的,还会给出新增加的打击策略类型的数值定义。
Step2. 开发者在应用中调用本接口,判断是否需要对用户实施深入打击。
Step3. 对于需要进行深入打击的用户,游戏自己实施打击策略,打击策略即请求中传入的type值。

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

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部