Добавил: 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 |
Строка
Количество слотов
|
|
Тэги: |