获取服务器信息 API
- 后端服务为Go UDP多线程查询.
接口地址
https://f.upkk.com/plugin.php?id=SRCDS_API:GetServerInfo
接口说明
该 API 用于获取 Counter-Strike: Global Offensive 服务器信息。
- 仅限租用或接入用户
- 遵循 Valve A2S 查询协议
- 普通用户 5~8 分钟更新一次,高级服务为 2 分钟
- 高级服务数据缓存周期 8 天 , 普通用户为24小时.
请求参数
参数名 | 类型 | 必填 | 描述 |
---|---|---|---|
token | string | 是 | API token 这里获取 |
userid | int | 是 | 用户UID |
fid | int | 是 | 服务器ID |
注意事项
- 接口会缓存最后一次成功返回数据.
- 如参数
dataServer.alive_timestamp
和dataServer.QueryTime
差距超过较长时间则代表您的服务器已无法被正确查询到,不过仍可返回上一次成功的缓存数据 仅dataServer.QueryTime
时间戳会被更新
// 就像是
if(dataServer.QueryTime - dataServer.alive_timestamp > 900)
{
//服务器挂了超过900秒拉!!!
//你的代码动作
}
返回值
参数名 | 类型 | 描述 |
---|---|---|
dataServer.Protocol | int | 服务器协议版本 |
dataServer.dataServer.HostName | string | 服务器名称 |
dataServer.Map | string | 当前地图名称 |
dataServer.ModDir | string | 游戏模组目录 |
dataServer.ModDesc | string | 游戏模组描述 |
dataServer.AppID | int | Steam App ID |
dataServer.Players | int | 在线玩家数量 |
dataServer.MaxPlayers | int | 最大玩家数量 |
dataServer.Bots | int | 机器人数量 |
dataServer.Dedicated | string | 服务器类型 |
dataServer.Os | string | 服务器操作系统 |
dataServer.Password | bool | 是否需要密码 |
dataServer.Secure | bool | 是否是 VAC 保护的服务器 |
dataServer.Version | string | 服务器版本 |
dataServer.ExtraDataFlags | int | 额外数据标记 |
dataServer.GamePort | int | 服务器端口 |
dataServer.SteamID | int | Steam ID |
dataServer.GameTags | string | 游戏标签 |
dataServer.GameID | int | 游戏 ID |
dataServer.QueryTime | int | 查询时间戳 |
dataServer.Address | string | 服务器地址 |
dataServer.version_lastest | string | 最新版本号 |
dataServer.alive_timestamp | int | 数据返回时间戳 |
dataServer.UseTime | string | 服务器查询耗时 |
dataPlayer | array | 在线玩家信息列表 |
dataPlayer.Name | int | 玩家名称 |
dataPlayer.Frags | int | 玩家得分 |
dataPlayer.time | int | 在线时间(秒) |
dataPlayer.timeF | string | 在线时间(已格式化) |
owneruid | int | 服务器管理员 UID |
UpdateTime | int | 数据更新时间戳 |
dataBytes | array | 返回数据包字节信息大小 |
dataBytes.Players | int | 玩家信息字节数量Bytes |
dataBytes.Info | int | 信息字节数量Bytes |
TimeOutCount | int | 连续失败次数 当成功返回自动清 0 |
示例
请求:
https://f.upkk.com/plugin.php?id=SRCDS_API:GetServerInfo&fid=你的服务器ID&token=你的TOKEN&userid=你的UID
响应:
{
"token": "c46c90pAt9daq0OdG9iOTXlOQHC1aYLlmxvWPnwfw0qnVJuDDAAveotEzJtHEiVwMCLIRquPqvtuShAxlDQ",
"dataServer": {
"Protocol": 17,
"HostName": "服务器名称",
"Map": "de_mirage",
"ModDir": "csgo",
"ModDesc": "Counter-Strike: Global Offensive",
"AppID": 730,
"Players": 0,
"MaxPlayers": 32,
"Bots": 0,
"Dedicated": "d",
"Os": "l",
"Password": false,
"Secure": true,
"Version": "1.38.5.5",
"ExtraDataFlags": 177,
"GamePort": 27015,
"SteamID": 110,
"GameTags": "empty,5v5,match,retake,xnet,secure",
"GameID": 730,
"QueryTime": 1677071412,
"Address": "192.168.50.204",
"version_lastest": "13855",
"alive_timestamp": 1677068529,
"UseTime": "0.115"
},
"dataPlayer": [],
"owneruid": 480,
"UpdateTime": 1677071412,
"dataBytes": {
"Players": 2,
"Info": 517
},
"TimeOutCount": 44
}
作者:admin 创建时间:2023-02-23 10:44
最后编辑:admin 更新时间:2024-09-25 02:22
最后编辑:admin 更新时间:2024-09-25 02:22