API запросов

Мы предоставляем сервис для получения сведений о мастерсерверах. Все данные передаются в формате JSON. Примеры запросов указаны ниже.

Получение статуса мастерсервера

Для получения статуса мастерсервера необходимо отправить следующий POST запрос на адрес http://api.hlmaster.info/

Параметры запроса представлены в таблице

Поле запроса	Данные
query	Строка "status"
ip	IP адрес и порт мастерсервера в формате xxx.xxx.xxx.xxx:xxxxx МастерСервер должен быть добавлен в список

Ответом будет JSON объект следующей структуры

Поле ответа

Данные

success

Логическое
В случае успеха - true
В случае неудачи - false

data

Доступен только в случае успеха
JSON объект:

Поле ответа	Данные
time	UNIX TIMESTAMP - время последней проверки
online	1/0 Доступен ли мастерсервер
srv_count	Количество серверов
country	Страна расположения мастерсервера, двухбуквенный код

error

Доступен только в случае неудачи
Строка с описанием ошибки
"ERR_BAD_QUERY" - Отсутствует один или несколько обязательных параметров
"ERR_NOT_REGISTERED" - Отсутствуют данные по запрошенному серверу
"ERR_UNKNOWN" - Произошла непредвиденная ошибка, повторите попытку через несколько минут

Получение списка серверов мастерсервера

Для получения всего списка серверов из мастерсервера необходимо выполнить POST запрос к адресу http://api.hlmaster.info/

Параметры запроса представлены в таблице

Поле запроса	Данные
query	Строка "getlist"
ip	IP адрес и порт мастерсервера в формате xxx.xxx.xxx.xxx:xxxxx МастерСервер должен быть добавлен в список

Ответом будет JSON объект следующей структуры

Поле ответа	Данные
success	Логическое В случае успеха - true В случае неудачи - false
data	Доступен только в случае успеха JSON массив, содержащий адреса серверов
error	Доступен только в случае неудачи Строка с описанием ошибки "ERR_BAD_QUERY" - Отсутствует один или несколько обязательных параметров "ERR_NOT_REGISTERED" - Отсутствуют данные по запрошенному серверу "ERR_UNKNOWN" - Произошла непредвиденная ошибка, повторите попытку через несколько минут

Поиск сервера в списках мастерсерверов

Для получения списка мастерсерверов, в которых содержится указанный HLDS сервер необходимо выполнить POST запрос к адресу http://api.hlmaster.info/

Параметры запроса представлены в таблице

Поле запроса	Данные
query	Строка "findhl"
ip	IP адрес и порт сервера в формате xxx.xxx.xxx.xxx:xxxxx

Ответом будет JSON объект следующей структуры

Поле ответа	Данные
success	Логическое В случае успеха - true В случае неудачи - false
data	Доступен только в случае успеха JSON массив, содержащий адреса мастерсерверов и позици запрошенного сервера в выдаче каждого мастерсервера
error	Доступен только в случае неудачи Строка с описанием ошибки "ERR_BAD_QUERY" - Отсутствует один или несколько обязательных параметров "ERR_UNKNOWN" - Произошла непредвиденная ошибка, повторите попытку через несколько минут