背景：

  • 乐牛用于获取CP的服务器列表信息，用于提供给CP运营对游戏的生态情况进行分析，乐牛会为CP提供唯一的游戏ID，当CP有多个版本时，但对于乐牛来说只属于当一个游戏.。

特别说明 （请务必查看）：

 保证不同的生态服保证有唯一区服标识符。
 保证同一个生态服有相同唯一区服标识符。
 保证同一个生态服的区服标识符保持不变。
 保证在通过（乐牛SDK）相关接口涉及的服务器的唯一标识符。

主要目的： 1.同一游戏下，只要是属于两个不同的生态服，区服标识都需要保证唯一。在区服标识不唯一情况下：（例如：IOS与安卓两个平台，在数据不互通的情况下，安卓1服传1，IOS1服也传1），这样会导致我们的数据统计不真实，运营无法准确评估游戏的生态情况， 不好对游戏精细化运营，吸引玩家。

2.乐牛需要一些区服相关的信息，例如开服时间，服务器名称，区服平台大区，合服信息来协助我们做数据处理。避免CP相关与区服相关的运营报表数据，增加CP工作量。

请求域名和请求方式:

  • http://xxx.com 由代理方提供 （请求方式：POST，Content-Type：application/x-www-form-urlencoded）
参数名 是否必须 类型 说明
game_id 是 int 游戏ID，由乐牛提供
time 是 int 时间戳，秒级
sign 是 string 验签规则: md5(game_id + time +　key) key的值由乐牛提供
ext 否 string 备用参数

返回格式（json）以下是返回的相关参数:

参数名 是否必须 类型 说明
code 是 int 返回码，0代表成功，其余状态代理方自定义
msg 是 string 接口调用后的返回说明
data 是 list 返回的区服信息list

data字段详情

参数名 是否必须 类型 说明
areas 是 list 服务器列表：相关字段见 areas字段详情

areas字段详情

参数名 是否必须 类型 说明
area_no 是 string 大区唯一标识符，如 CN
name 是 string 大区平台名称，如华南1区，海外专区
servers 是 list 区服务器列表：详情见servers字段详情

servers字段详情

参数名 是否必须 类型 说明
name 是 string 区服名称
server_no 是 string 唯一区服标识符：保证游戏下是全局唯一，假如只保证当前平台是唯一的，可以通过在原有的区服标识符(server_id)增加大区唯一标识符作为前缀如, area_no = CN， server_id = "S1"，哪么server_no为：CN_S1
plan_time 是 int 区服开服时间戳（秒级）
is_history 是 enum(1,2) 是否是历史服，1代表是； 2 代表否
son 是 string 子服区服标识符，用英文逗号进行分隔
status 否 string 服务器状态，1开服；-1停服维护；该字段不传则代表1

说明： 1-2-3合成1服，那1、2、3服都是is_history=1； 2、3服的son是空的，1服的son是“2，3”

返回示例:

正确时返回:

{
    "data": {
        "areas": [
            {
                "name": "中国大区",
                "area_no": "cn",
                "servers": [
                    {
                        "plan_time": 1558945988,
                        "name": "1服-流星剑梦",
                        "server_no": "CN_S1",
                        "is_history": 1,
                        "son": "S2,S3"
                    },
                    {
                        "plan_time": 1558946988,
                        "name": "2服-神火大陆",
                        "server_no": "CN_S2",
                        "is_history": 1,
                        "son": ""
                    }
                ]
            },
            {
                "name ": "日本",
                "area_no ": "jp",
                "servers ": [
                    {
                        "plan_time": 1558945988,
                        "name": "1服-梦回大地",
                        "server_no": "JP_S1",
                        "is_history": 2,
                        "son": ""
                    },
                    {
                        "plan_time": 1558945988,
                        "name": "2服-六脉神剑",
                        "server_no": "JP_S2 ",
                        "is_history": 2,
                        "son": ""
                    }
                ]
            }
        ]
    },
    "code": 0,
    "msg": "succ"
}

错误时返回:

  {
    "code": 1,
    "errmsg": "sign error"
  }

备注:

  • 暂无