跳到主要内容

区服同步

备注

此部分功能可选接入，请根据游戏内容与平台人员沟通是否需要接入这些功能。

游戏方将游戏的区服列表主动告知平台，以便平台能够在进入游戏前选择区服，和在合适的位置展示开服表（目前仅限 PC 页游）。

公共字段​

区服信息字段​

参数类型说明示例
namestring区服名称迅雷 1 服
server_idint64区服 ID1
open_atstring开服时间2024-04-16 18:00:00
displaystring是否展示"0" - 不展示, "1" - 展示

新增区服信息​

请求地址​

https://api2-youxi.xunlei.com/open/game/syncserver

请求体概述​

  • HTTP 请求方法：POST
  • HTTP 请求标头：Content-Type: application/json

请求示例​

curl --location 'api2-youxi.xunlei.com/open/game/syncserver' \
    --header 'Content-Type: application/json' \
    --data '{
    "game_id": "cdrg0rjrc8k0m7af5fcg",
    "time": 1713239399,
    "servers": "[{\"name\":\"迅雷一服\",\"server_id\":12222222,\"open_at\":\"2024-04-16 18:00:00\"},{\"name\":\"迅雷二服\",\"server_id\":12222223,\"open_at\":\"2024-04-16 18:00:00\"},{\"name\":\"迅雷三服\",\"server_id\":12222224,\"open_at\":\"2024-04-16 18:00:00\", \"display\":\"0\"}]",
    "sign": "1b3b2bd33d89fba34c0438fc0d833f9e"
    }'

请求参数说明​

参数类型说明示例
game_idstring游戏 IDcdrg0rjrc8k0m7af5fcg
timeint64当前时间戳1713239399
serversstring区服列表 JSON 字符串'[{"name":"迅雷一服","server_id":12222222,"open_at":"2024-04-16 18:00:00"}]'
signstring签名（查看签名规则）1b3b2bd33d89fba34c0438fc0d833f9e

响应示例​

{
  "code": 0,
  "message": "ok"
}

响应参数说明​

参数类型说明
codeint32业务码
messagestring业务信息

更新区服信息​

请求地址​

https://api2-youxi.xunlei.com/open/game/updateserver

请求体概述​

  • HTTP 请求方法：POST
  • HTTP 请求标头：Content-Type: application/json

请求参数​

参数类型说明示例
game_idstring平台的游戏 IDcdrg0rjrc8k0m7af5fcg
timeint64当前时间戳1713239399
serversstring区服列表 JSON 字符串'[{"name":"迅雷一服","server_id":12222222,"open_at":"2024-04-16 18:00:00"}]'
signstring签名（查看签名规则）1b3b2bd33d89fba34c0438fc0d833f9e

请求示例​

curl --location 'api2-youxi.xunlei.com/open/game/updateserver' \
    --header 'Content-Type: application/json' \
    --data '{
    "game_id": "cdrg0rjrc8k0m7af5fcg",
    "time": 1713239399,
    "servers": "[{\"name\":\"迅雷一服\",\"server_id\":12222222,\"open_at\":\"2024-04-16 18:00:00\"},{\"name\":\"迅雷二服\",\"server_id\":12222223,\"open_at\":\"2024-04-16 18:00:00\"},{\"name\":\"迅雷三服\",\"server_id\":12222224,\"open_at\":\"2024-04-16 18:00:00\", \"display\":\"1\"}]",
    "sign": "4bfd25a81d62d6b296e516b67df57046"
    }'

响应示例​

{
  "code": 0,
  "message": "ok"
}

响应参数说明​

字段名值类型说明
codeint32业务码
messagestring业务信息

响应业务码​

业务码业务码说明
0成功