Меню сайта


[DS]: Half-Life Server
[DS]: Half-Life Server


[DS]: CS:S GunGame v34 Server
[DS]: CS:S GunGame v34 Server


[DS]: CS:S v34 Server
[DS]: CS:S v34 Server


Поиск

add_newДобавить новость
Последние добавленные

just a retexture i did of a popular skin pack

Читать далее

<JAM>
m1-palinka


HL-HEV
hl-hev

DS-Servers
Помощь
API
Получение информации о серверах


Получение информации о серверах

Добавил: root
2015-12-19 21:30:10
373 просмотра

В этом документе описано API получение информации о серверах.

В каждом описанном запросе должен применяться ключ авторизации. Подробнее об авторизации здесь.

1. Получение списка своих серверов

Для получения списка своих серверов необходимо сделать авторизированный POST запрос на адрес http ://api.ds-servers.com/servers/my.dse

В ответе будет объект JSON.

Если в поле "success" содержится значение true, то в поле data содержится массив ID серверов.

в противном случае запрос выполнен с ошибкой.

2. Получение информации о серверах в реальном времени

Ограничения:

  • Не более 20 серверов за 1 запрос

Особенности:

  • Результат запроса к серверу кэшируется на 30 секунд
  • Запросы к серверам выполняются в реальном времени, поэтому время ответа может быть большим

Для получения информации о серверах в реальном времени необходимо выполнить POST запрос на адрес http ://api.ds-servers.com/servers/info/query.dse

В качестве параметров запроса необходимо указать массив id[] серверов (Не более 20 штук) ID сервера может быть найден на странице соответствующего сервера.

В ответе будет объект JSON.

Если в поле "success" содержится значение true, то в поле data содержится объект с информацией о запрошенных серверах. В противном случае запрос выполнен с ошибкой.

объект data:

Ключ Значение

<id>

id сервера

объект:

id

Целое

id сервера

ip

строка

IP:Port сервера

online

Логическое

Статус сервера

modname

Строка

Ключ модификации (пример goldsrc.valve)

servername

Строка

Название сервера

mapname

Строка

Название карты

players

Строка

Количество игроков на данный момент и максимальное

пример: (2 / 32)

country

Строка

Название страны расположения

city

Строка

Название города расположения

slots

Строка

Количество слотов

2. Получение информации о серверах в из базы

Ограничения:

  • Не более 200 серверов за 1 запрос

Особенности:

  • В настоящий момент обновление информации в базе происходит раз в 10 минут
  • Запросов к серверам не выполняется, ответ приходит быстро

Для получения информации о серверах в из базы необходимо выполнить POST запрос на адрес http ://api.ds-servers.com/servers/info/request.dse

В качестве параметров запроса необходимо указать массив id[] серверов (Не более 200 штук) ID сервера может быть найден на странице соответствующего сервера.

В ответе будет объект JSON.

Если в поле "success" содержится значение true, то в поле data содержится объект с информацией о запрошенных серверах. В противном случае запрос выполнен с ошибкой.

объект data:

Ключ Значение

<id>

id сервера

объект:

id

Целое

id сервера

ip

строка

IP:Port сервера

modname

Строка

Ключ модификации (пример goldsrc.valve)

servername

Строка

Название сервера

mapname

Строка

Название карты

players

Строка

Количество игроков на данный момент и максимальное

пример: (2 / 32)

country

Строка

Название страны расположения

city

Строка

Название города расположения

slots

Строка

Количество слотов

Поделиться:
Тэги: