跳转至

游戏区服列表查询接口

在游戏官网上,玩家可以选择进行外购虚拟货币的购买,此时需要游戏提供游戏区服列表,供网页调用。

请求方式

请求方式 请求地址 返回content-type 请求方 接收方
GET {GAME_SERVERLIST_QUERY_URL} application/json 发行SDK服务端 游戏服务端

请求参数

参数名 是否必填 类型 签名因子? 说明
instanceKey String 发行SDK平台分配的游戏实例key
status Int 返回服务器状态类型。0代表所有服,1代表当前对外开放的服
ts Int 服务器时间戳(秒),请求服务器与响应服务器时间戳相差超过1小时,则返回错误
sign String 签名 参考签名规则

返回结果

返回结果code值请参考返回值信息

{
    "code": 200,
    "msg": "OK",
    "data": [
        {
            "serverId": "OBT_001",
            "serverName": "公测1服",
            "zoneId": "official",
            "zoneName": "官方大区",
            "status": 1
        },
        {
            "serverId": "OBT_002",
            "serverName": "公测2服",
            "zoneId": "official",
            "zoneName": "官方大区",
            "status": 1
        },
        {
            "serverId": "CPS_001",
            "serverName": "天涯聚首1服",
            "zoneId": "cps",
            "zoneName": "CPS混服大区",
            "status": 0
        },
        ...
    ] 
}
{
    "code": 400,
    "msg": "signature error"
}

返回参数

参数名 是否必填 类型 说明
serverId String 服id
serverName String 服名称
zoneId String 大区id
zoneName String 大区名称
status Int 服状态。0为关闭的服,1为开放的服