当前位置:首页 > 帮助文档 > 屏蔽字库接入说明

掌趣平台字库获取服务接口定义-web版

1.接入必读



该接口由掌趣技术平台提供,负责提供平台字库信息

有关英文单词或者缩写、网址类的屏蔽词,区分大小写,使用时需要注意!


1.1接入准备


1.接入前需要先联系运营团队,获取自己产品的字库获取地址;

注意:该接口返回字库列表需要游戏研发进行缓存,建议每30分钟更新一次;

1.2接口协议

1.接口类型:HTTP

2.提交方式:HTTP GET

3.消息数据格式:JSON

4.接口地址(地址需要联系运营人员获取,每个产品不一样)

1.3接口描述

1.请求参数

根据获取到的接口地址进行请求,地址需要追加checksum参数,用以校验字库数据是否变化;

checksum:取值于上次请求结果中的checksum字段值;

首次访问时checksum传08c0372780bcbd1eb73ceca2f03f319b
例如:http://gscservice.gamebean.net/gscproxy/s/100301.htm?pid=10000538&sid=1001&checksum=08c0372780bcbd1eb73ceca2f03f319b

2.返回参数

参数名类型参数说明
status字符串状态码,0失败,1成功
reset字符串详细状态码
updateTime字符串策略最后更新时间
keyList字符串返回的关键字数据
desc字符串描述

范例:


详细状态码状态描述出现场景
1000成功 
9999未知异常错误在出现平台已知异常之外的异常时
g240该产品未激活字库获取服务未激活字库的产品访问
g241该IP未授权使用字库服务IP不允许访问
g242该策略已经暂停服务策略已经暂停
g243该产品已暂停该字库获取服务该产品在平台上配置的状态为暂停