跳至主要內容

GET /get/v2/a2s-server

TASA-Ed工作室...大约 6 分钟约 1683 字

A2S 获取服务器信息

使用 A2S 协议获取起源游戏服务器信息，需要 UDP 请求，可能被屏蔽。

Query

format string

输出格式，默认为 json，可选值为 json、xml

  • 默认：json
  • 示例：json

port integer

端口号，默认为 27015

  • 默认：27015
  • 示例：27015

hostname string 必填

主机名，必填

  • 示例：example.com

Responses

200

服务器信息

Body
application/json
  • bots integernull
  • data stringnull
  • game stringnull
  • game_id integer
  • map stringnull
  • players stringnull
  • port integernull
  • protocol integernull
  • server_os stringnull
  • success boolean 必填
  • title stringnull
  • vac booleannull
  • version stringnull
  • visibility booleannull
{
  "bots": "string",
  "data": "string",
  "game": "string",
  "game_id": 0,
  "map": "string",
  "players": "string",
  "port": "string",
  "protocol": "string",
  "server_os": "string",
  "success": true,
  "title": "string",
  "vac": "string",
  "version": "string",
  "visibility": "string"
}
application/xml
  • bots integernull
  • data stringnull
  • game stringnull
  • game_id integer
  • map stringnull
  • players stringnull
  • port integernull
  • protocol integernull
  • server_os stringnull
  • success boolean 必填
  • title stringnull
  • vac booleannull
  • version stringnull
  • visibility booleannull
<root>
  <bots>string</bots>
  <data>string</data>
  <game>string</game>
  <game_id>0</game_id>
  <map>string</map>
  <players>string</players>
  <port>string</port>
  <protocol>string</protocol>
  <server_os>string</server_os>
  <success>true</success>
  <title>string</title>
  <vac>string</vac>
  <version>string</version>
  <visibility>string</visibility>
</root>

400

参数错误

Body
application/json
  • bots integernull
  • data stringnull
  • game stringnull
  • game_id integer
  • map stringnull
  • players stringnull
  • port integernull
  • protocol integernull
  • server_os stringnull
  • success boolean 必填
  • title stringnull
  • vac booleannull
  • version stringnull
  • visibility booleannull
{
  "bots": "string",
  "data": "string",
  "game": "string",
  "game_id": 0,
  "map": "string",
  "players": "string",
  "port": "string",
  "protocol": "string",
  "server_os": "string",
  "success": true,
  "title": "string",
  "vac": "string",
  "version": "string",
  "visibility": "string"
}
application/xml
  • bots integernull
  • data stringnull
  • game stringnull
  • game_id integer
  • map stringnull
  • players stringnull
  • port integernull
  • protocol integernull
  • server_os stringnull
  • success boolean 必填
  • title stringnull
  • vac booleannull
  • version stringnull
  • visibility booleannull
<root>
  <bots>string</bots>
  <data>string</data>
  <game>string</game>
  <game_id>0</game_id>
  <map>string</map>
  <players>string</players>
  <port>string</port>
  <protocol>string</protocol>
  <server_os>string</server_os>
  <success>true</success>
  <title>string</title>
  <vac>string</vac>
  <version>string</version>
  <visibility>string</visibility>
</root>

422

hostname 错误

Body
application/json
  • bots integernull
  • data stringnull
  • game stringnull
  • game_id integer
  • map stringnull
  • players stringnull
  • port integernull
  • protocol integernull
  • server_os stringnull
  • success boolean 必填
  • title stringnull
  • vac booleannull
  • version stringnull
  • visibility booleannull
{
  "bots": "string",
  "data": "string",
  "game": "string",
  "game_id": 0,
  "map": "string",
  "players": "string",
  "port": "string",
  "protocol": "string",
  "server_os": "string",
  "success": true,
  "title": "string",
  "vac": "string",
  "version": "string",
  "visibility": "string"
}
application/xml
  • bots integernull
  • data stringnull
  • game stringnull
  • game_id integer
  • map stringnull
  • players stringnull
  • port integernull
  • protocol integernull
  • server_os stringnull
  • success boolean 必填
  • title stringnull
  • vac booleannull
  • version stringnull
  • visibility booleannull
<root>
  <bots>string</bots>
  <data>string</data>
  <game>string</game>
  <game_id>0</game_id>
  <map>string</map>
  <players>string</players>
  <port>string</port>
  <protocol>string</protocol>
  <server_os>string</server_os>
  <success>true</success>
  <title>string</title>
  <vac>string</vac>
  <version>string</version>
  <visibility>string</visibility>
</root>

500

获取服务器信息失败

Body
application/json
  • bots integernull
  • data stringnull
  • game stringnull
  • game_id integer
  • map stringnull
  • players stringnull
  • port integernull
  • protocol integernull
  • server_os stringnull
  • success boolean 必填
  • title stringnull
  • vac booleannull
  • version stringnull
  • visibility booleannull
{
  "bots": "string",
  "data": "string",
  "game": "string",
  "game_id": 0,
  "map": "string",
  "players": "string",
  "port": "string",
  "protocol": "string",
  "server_os": "string",
  "success": true,
  "title": "string",
  "vac": "string",
  "version": "string",
  "visibility": "string"
}
application/xml
  • bots integernull
  • data stringnull
  • game stringnull
  • game_id integer
  • map stringnull
  • players stringnull
  • port integernull
  • protocol integernull
  • server_os stringnull
  • success boolean 必填
  • title stringnull
  • vac booleannull
  • version stringnull
  • visibility booleannull
<root>
  <bots>string</bots>
  <data>string</data>
  <game>string</game>
  <game_id>0</game_id>
  <map>string</map>
  <players>string</players>
  <port>string</port>
  <protocol>string</protocol>
  <server_os>string</server_os>
  <success>true</success>
  <title>string</title>
  <vac>string</vac>
  <version>string</version>
  <visibility>string</visibility>
</root>

504

获取服务器信息超时

Body
application/json
  • bots integernull
  • data stringnull
  • game stringnull
  • game_id integer
  • map stringnull
  • players stringnull
  • port integernull
  • protocol integernull
  • server_os stringnull
  • success boolean 必填
  • title stringnull
  • vac booleannull
  • version stringnull
  • visibility booleannull
{
  "bots": "string",
  "data": "string",
  "game": "string",
  "game_id": 0,
  "map": "string",
  "players": "string",
  "port": "string",
  "protocol": "string",
  "server_os": "string",
  "success": true,
  "title": "string",
  "vac": "string",
  "version": "string",
  "visibility": "string"
}
application/xml
  • bots integernull
  • data stringnull
  • game stringnull
  • game_id integer
  • map stringnull
  • players stringnull
  • port integernull
  • protocol integernull
  • server_os stringnull
  • success boolean 必填
  • title stringnull
  • vac booleannull
  • version stringnull
  • visibility booleannull
<root>
  <bots>string</bots>
  <data>string</data>
  <game>string</game>
  <game_id>0</game_id>
  <map>string</map>
  <players>string</players>
  <port>string</port>
  <protocol>string</protocol>
  <server_os>string</server_os>
  <success>true</success>
  <title>string</title>
  <vac>string</vac>
  <version>string</version>
  <visibility>string</visibility>
</root>