区服接口
接口说明
可选。厂商在自接入后台填写区服列表地址后,平台定时用 GET 拉取当前区服。未填写则不拉取,区服仍可在平台后台手工维护。
平台每 24 小时拉一次。游戏内部开服、改名、合服仍改自己的区服表;本接口只返回当前列表。合服或关服:旧服 visible 为 0,或不再出现在列表中。
请求方式
- Method:
GET - Path:厂商在自接入后台配置的区服地址,平台调用时自动拼接查询参数
参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appid | string | 是 | 平台游戏唯一ID |
| time | int | 是 | 时间戳(秒) |
| sign | string | 是 | 签名,参与签名(appid, time),密钥为登录密钥 |
示例:
GET {server_url}?appid=ki10000&time=1773919153&sign=...待签串:
appid=ki10000&time=1773919153&secret=login_secret签名算法见 签名规则。
返回值说明
返回体为区服列表,每项为英文逗号分隔字符串:
区服名称,区服ID,开服时间,是否推荐,是否可见
json
{
"server": [
"测试1区,S1,2023-11-11 12:12:12,1,1",
"测试2区,S2,2023-11-12 12:12:12,0,1"
]
}| 位置 | 示例值 | 含义 | 是否必填 |
|---|---|---|---|
| 参数1 | 测试1区 | 区服名称 | 是 |
| 参数2 | S1 | 区服编号 | 是 |
| 参数3 | 2023-11-11 12:12:12 | 开服时间 | 是 |
| 参数4 | 0 | 是否推荐区服: 0:不推荐 1:推荐(默认) | 否 |
| 参数5 | 0 | 区服是否显示: 0:不显示 1:显示(默认) | 否 |
| 参数名 | 类型 | 说明 |
|---|---|---|
| server | array | 当前区服列表 |
测试
在自接入后台填写区服地址后点击「测试」。平台会按上述参数 GET 该地址,并展示 HTTP 状态与返回内容。未填写则不测,也不影响登录、支付提审。