当前位置:首页 > 帮助文档 > 聊天信息接入说明

掌趣平台统一游戏角色禁言封停接口(游戏负责实现,掌趣平台访问)

1 接入必读



该接口由游戏开发者按如下规范提供,掌趣平台通过该接口实现角色禁言或封停功能

 

1.1 接入准备



1. 确保接入产品已经创建游戏服信息,接入调试时采用已经创建的游戏服进行调试。

2. 接口地址预先提交给掌趣项目负责人进行配置。


 

1.2 接口协议


1.接口类型:HTTP
2.提交方式:HTTP POST,数据(json串)直接放于消息体中传输.非表单形式;
3.消息数据格式:JSON
4.接口地址:预先提交给掌趣项目负责人进行配置;

 

 

1.3 网络安全

为了保证数据安全性,建议游戏服务器对掌趣的请求IP地址做鉴权处理,需要认证的IP如下:
 国内
223.202.94.122
223.202.94.124
223.202.94.105
223.202.94.251
103.235.233.4

香港
112.73.10.208
112.73.10.209
128.1.62.2
128.1.62.10

欧美
47.89.178.122
47.89.179.174

 

 

2 接入描述

2.1 角色封停/禁言


1. 请求参数

参数名称类型重要性参数说明
service字符串必填接口标识,该接口固定为palm.platfom.productServer.shutUp
type字符串必填

BANROLE:封角色
BANSPEAKING:禁言

serverId字符串必填游戏服ID
data[...].userId字符串必填用户ID;data[…]表示同时可传多条聊天记录,以数组形式传递;下面类似;
data[...].roleId字符串必填角色ID
data[...].beginTime字符串必填禁言开始时间,格式为(yyyy-MM-dd HH:mm:ss)
data[...].endTime字符串必填禁言结束时间,格式为(yyyy-MM-dd HH:mm:ss)


2. 返回参数

参数名称类型说明
errorCode字符串错误码;
00000:处理成功
00001:处理失败
errorDesc字符串描述

 

范例:


JSON调用如下

request:


response: