游戏区服列表查询接口
在游戏官网上,玩家可以选择进行外购虚拟货币的购买,此时需要游戏提供游戏区服列表,供网页调用。
请求方式
| 请求方式 | 请求地址 | 返回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
},
...
]
}
返回参数
| 参数名 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| serverId | 是 | String | 服id |
| serverName | 是 | String | 服名称 |
| zoneId | 否 | String | 大区id |
| zoneName | 否 | String | 大区名称 |
| status | 是 | Int | 服状态。0为关闭的服,1为开放的服 |