Данное API предоставляет доступ к сервисам IP-Games для программ сторонних разработчиков.

В настоящий момент API находится в состоянии активной разработки и может быть изменено.

Старая версия API - http://xml.ip-games.ru/

Базовая информация

Access point для всех запросов к API - http://api.ip-games.ru/.

Например, для вывода сервера, нужно послать GET запрос на адрес http://api.ip-games.ru/server?key=0fdb44af147f25c820ea51f148439e62.

Получение ключа

Ключ для работы с API может быть получен двумя способами:

  1. В панели настроек сервера.
  2. Через GET запрос к методу /auth с логином, паролем и адресом сервера
Возвращает ключ доступа к API для пользователя с указанной комбинацией email-password.
Метод
GET
Ресурс
/auth
Параметры
  • login - логин пользователя
  • password - пароль пользователя
  • server - ip-адрес сервера
Пример
http://api.ip-games.ru/auth?login=ваш_логин/почта&password=ваш_пароль&server=127.0.0.1:22222
Результат
<key>
  0fdb44af147f25c820ea51f148439e62
</key>

Вывод сервера

Выводится статистика определенного сервера.
Метод
GET
Ресурс
/server
Параметр
  • key - ключ API
Примеры
скачать php файл [RAR]
скачать php файл (с использованием кеширования) [RAR]
Результат
<server url="http://api.ip-games.ru/">
  <server_id>00000</server_id>
  <game>
  <name>Counter-Strike 1.6</name>
  <game_code>cs16</game_code>
  </game>
  ...
</server>
Список переменных
  • server_id - id сервера
  • status - статус сервера (1 - работает, 0 - не работает)
  • homepage - страница сервера
  • game - игра сервера
  • gcode - сокращение игры сервера
  • hostname - название сервера (имя)
  • maps - карта на сервере
  • connect - ссылка на подключение к серверу
  • location - расположение игрового сервера
  • online - сколько игроков сейчас на сервере
  • maxonline - максимальное количество игроков на сервере
  • ip - ip:port адрес сервера
  • vote - голосов у сервера
  • ping - пинг сервера (от ip-games.ru до сервера)
  • rang - ранг сервера по определенной игре
  • globalrank - глобальный ранг сервера
  • uptime - аптайм сервера за 7 дней. Указано в процентах (% от 0 до 100).
  • update - отсчет времени после последнего обновления сервера

Вывод проголосовавших

Выводит список проголосовавших за сервер.
Метод
GET
Ресурс
/votes
Параметр
  • key - ключ API
Пример
http://api.ip-games.ru/votes?key=0fdb44af147f25c820ea51f148439e62
Результат
<server url="http://api.ip-games.ru/">
  <server_id>0</server_id>
  <vote>
    <name>*скрыто*</name>
    <vote_stats>1</vote_stats>
    <ip_address>127.0.0.1</ip_address>
    <vote_date>2014-01-01 23:23:23</vote_date>
  <vote>
  <vote>
    <name>*скрыто*</name>
    <vote_stats>2</vote_stats>
    <ip_address>127.0.0.1</ip_address>
    <vote_date>2014-01-01 21:21:21</vote_date>
  <vote>
</server>
Метод
POST
Список переменных
  • server_id - id сервера
  • name - имя проголосовавшего (незарегистрированный = Гость)
  • vote_stats - голос (1 - лайк, 2 - дислайк)
  • ip_address - ip-адрес проголосовавшего
  • vote_date - дата и время проголосовавшего

Вывод проголосовавших с оповещением

Выводит список проголосовавших за сервер.
Параметры
  • IPG_ID - id сервера
  • IPG_USER_IP - ip-адрес проголосовавшего
  • IPG_GAME_NICK - ник проголосовавшего (указывается на странице голосования)
  • IPG_REG_NICK - ник зарегистрированного на сайте мониторинга
  • IPG_HASH - цифровая подпись
Пример
скачать php файл [RAR]
Настройка
Настроить данный способ оповещения можно по этой ссылке, на странице настройки сервера

Для хостинг-провайдеров

Автодобавление игровых серверов в мониторинг.
Метод
POST
Ресурс
/serveradd
Пример
скачать php файл [RAR]
Список переменных
  • server_ip - ip-адрес сервера
  • qport - Query Port
  • server_url - адрес добавленного сервера
  • server_game - полное название игры
  • code - тип игры сервера
  • server_email - почта администратора сервера
  • add_date - дата и время добавления сервера
Список возможных ошибок
  • 010 - не указан API-ключ
  • 011 - API-ключ не найден в нашей базе
  • 012 - cервер не отвечает
  • 013 - не поддерживаемый тип игры
  • 014 - сервер уже добавлен в мониторинг
Для подключения, обращайтесь по этим контактам.
Яндекс.Метрика

2014 © "IP-Games" - Онлайн мониторинг серверов

По всем вопросам обращайтесь: support@ip-games.ru