获取服务器信息 API

接口说明

该 API 用于获取 Counter-Strike: Global Offensive 服务器信息。

  • 仅限租用或接入用户
  • 遵循 Valve A2S 查询协议
  • 普通用户 5~8 分钟更新一次,高级服务为 2 分钟
  • 高级服务数据缓存周期 8 天 , 普通用户为24小时.

    请求参数

参数名 类型 必填 描述
token string API token 这里获取
userid int 用户UID
fid int 服务器ID

注意事项

  • 接口会缓存最后一次成功返回数据.
  • 如参数 dataServer.alive_timestampdataServer.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