Документация API

Создание API-ключа

Здесь вы можете создать/пересоздать личный ключ, который будет привязан к вашему аккаунту.

Если вы не понимаете зачем нужен ключ, то, пожалуйста, в целях собственной безопасности не говорите его никому.

Внимание! Чтобы создать ключ, выполните вход: https://api.ip-games.ru/account/login/

Информация о сервере

server.get

Подробная информация о конкретном сервере.

Пример запроса:

https://api.ip-games.ru/method/server.get?address=[server_address]&key=[your_secret_key]

Параметры запроса:
  • [server_address] — IP:PORT сервера
  • [your_secret_key] — ваш API-ключ
  • dev=1 — режим разработчика
Пример ответа:
{"result":{"response":200,"server_id":11927,"address":"193.26.217.40:27015","password":0,"game":{"code":"cs16","name":"Counter-Strike 1.6","img":"https:\/\/i.ip-games.ru\/game\/cs16.png"},"country":{"name":"\u0420\u043e\u0441\u0441\u0438\u044f","code":"ru","img":"https:\/\/i.ip-games.ru\/flags\/ru.png"},"name":"RUSSIAN SERVER \/ IP-GAMES.RU","status":1,"ping":24,"mod":"","players":{"now":6,"max":20},"map":{"name":"cs_assault","img":"https:\/\/i.ip-games.ru\/map\/cs16\/cs_assault\/1.jpg"},"votes":{"likes":534,"dislikes":2},"rangs":{"rang":23,"grang":56},"hosting":{"name":0,"url":0,"ico":0},"uptime":"100","homepage":"https:\/\/ip-games.ru\/s\/11927","update":1511635805,"key":false}}
Готовое решение:

Информация о сервере (PHP) [RAR] / Автор: -

Информация о сервере с использованием кеширования (PHP) [RAR] / Автор: -

Присылайте свои работы нам на почту: support@ip-games.ru

Статистика сервера

server.stats

Возвращает статистику посещений сервера по часам за указанный период

Пример запроса:

https://api.ip-games.ru/method/server.stats?address=[server_address]&key=[your_secret_key]

Параметры запроса:
  • [server_address] — IP:PORT сервера
  • [your_secret_key] — ваш API-ключ
Пример ответа:
[{"players":0,"ping":26,"time":1511730005},{"players":0,"ping":23,"time":1511731802},{"players":0,"ping":29,"time":1511733601},{"players":0,"ping":23,"time":1511735401},{"players":0,"ping":26,"time":1511737201},{"players":0,"ping":24,"time":1511739001}]

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

server.votes

Выводит список проголосовавших за сервер.

ВАЖНО! На вашем аккаунте сервер должен быть подтвержден.
Пример запроса:

https://api.ip-games.ru/method/server.votes?address=[server_address]&key=[your_secret_key]

Параметры запроса:
  • [server_address] — IP:PORT сервера
  • [your_secret_key] — ваш API-ключ
  • dev=1 — режим разработчика
Пример ответа:
[{"username":null,"voted":1,"ip":"178.206.23.248","date":1491851444},{"username":null,"voted":1,"ip":"178.206.9.226","date":1491846677},{"username":null,"voted":1,"ip":"176.52.73.78","date":1491834454},{"username":null,"voted":1,"ip":"85.26.234.114","date":1491833541},{"username":null,"voted":1,"ip":"95.78.106.76","date":1491833349},{"username":null,"voted":1,"ip":"178.205.64.211","date":1491833340}]
Пояснение к ответу:
  • voted — голос (1 - лайк, 2 - дислайк)

Поиск серверов

server.search
ВАЖНО! Метод server.search не работает

Выводит список найденых серверов в мониторинге.

Пример запроса:

https://api.ip-games.ru/method/server.search?q=[search_text]&key=[your_secret_key]

Параметры запроса:
  • [search_text] — строка запроса
  • [your_secret_key] — ваш API-ключ
  • dev=1 — режим разработчика
Пример ответа:
[]

Хостинг-провайдер

Добавить хостинг в каталог

Добавить сайт в каталог вы можете прямо сейчас, перейдите на страницу https://ip-games.ru/hosting/add и добавьте его в каталог.

hosting.all

Получить cписок всех хостинг-провайдеров в каталоге.

Пример запроса:

https://api.ip-games.ru/method/hosting.all?key=[your_secret_key]

Пример ответа:
[{"hosting_id":27,"name":"MyArena.ru"},{"hosting_id":1,"name":"Serva4ok.ru"},{"hosting_id":26,"name":"OurServers.ru"},{"hosting_id":28,"name":"Advens.ru"}]
hosting.get

Подробная информация о конкретном хостере.

Пример запроса:

https://api.ip-games.ru/method/hosting.get?id=[hosting_id]&key=[your_secret_key]

Параметры запроса:
  • [hosting_id] — индикатор хостинг-провайдера в каталоге, который можно узнать c помощью метода hosting.all.
  • [your_secret_key] — ваш API-ключ
  • dev=1 — режим разработчика
Пример ответа:
{"result":{"response":200,"hosting_id":27,"url":"myarena","name":"MyArena.ru","site":"http:\/\/www.myarena.ru","servers":2626,"players":11766,"ping":27,"uptime":"97.88"}}
hosting.servers

Подробная информация о конкретном хостере.

Пример запроса:

https://api.ip-games.ru/method/hosting.servers?id=[hosting_id]&key=[your_secret_key]

Параметры запроса:
  • [hosting_id] — индикатор хостинг-провайдера в каталоге, который можно узнать c помощью метода hosting.all.
  • [your_secret_key] — ваш API-ключ
  • dev=1 — режим разработчика
Пример ответа:
["46.174.55.161:27015","46.174.52.12:27301","46.174.53.138:27015","46.174.48.164:27015","46.174.49.39:27217","46.174.52.3:27248","46.174.52.165:27015","46.174.49.54:27306","46.174.50.57:27214","46.174.55.8:27015","46.174.54.221:27015"]
hosting.serverAdd

Добавление серверов в нашу базу через POST или GET запрос.

Пример запроса:

POST https://api.ip-games.ru/method/hosting.serverAdd?key=[hosting_secret_key]

GET https://api.ip-games.ru/method/hosting.serverAdd?server_ip=[server_ip]&server_game=[server_game]&qport=[qport]&key=[hosting_secret_key]

Параметры запроса:
  • [hosting_secret_key] — API-ключ хостинг-провайдера
  • game_list.txt — Список поддерживаемых игр
Параметры запроса (POST данные):
  • server_ip, qport, server_game
Параметры запроса (GET данные):
  • [server_ip] — IP:PORT сервера
  • [server_game] — игра сервера, список поддерживаемых игр
  • [qport] — Query Port
  • [key] — API-ключ хостинг-провайдера
  • dev=1 — режим разработчика
Пример ответа:
[{"server_ip":"193.26.217.106:27822","status":true,"comment":null},{"server_ip":"46.174.52.233:27015","status":false,"comment":"\u0421\u0435\u0440\u0432\u0435\u0440 \u0443\u0436\u0435 \u0435\u0441\u0442\u044c \u0432 \u0431\u0430\u0437\u0435"},{"server_ip":"88.198.47.43:27018","status":true,"comment":null},{"server_ip":"193.26.217.14:27172","status":true,"comment":null}]
Пояснение к ответу:
  • status — true = сервер добавлен в базу
  • comment - если status = false, тут указывается причина ошибки
Готовое решение:

Добавление серверов в базу POST (PHP) / Автор: -

Присылайте свои работы нам на почту: support@ip-games.ru

Список игр

games.all

Список доступных игр на сайте

Пример запроса:

https://api.ip-games.ru/method/games.all?key=[your_secret_key]

Параметры запроса:
  • [your_secret_key] — ваш API-ключ
  • dev=1 — режим разработчика
Пример ответа:
[{"game":"all","name":"All","servers":25078},{"game":"cs16","name":"Counter-Strike 1.6","servers":5732},{"game":"csgo","name":"Counter-Strike: Global Offensive","servers":3003},{"game":"teamspeak3","name":"TeamSpeak 3","servers":2945},{"game":"tf2","name":"Team Fortress 2","servers":2370}]

Changelog

24.04.2017

Запущена новая документация по API.