Документация 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-ключ;
  • param=vk,host — получить данные группы ВК и хостинге сервера
  • dev=1 — режим разработчика, служит для отладки запросов.
Пример ответа:
{"result":{"response":200,"status":1,"server_id":11927,"homepage":"https:\/\/ip-games.ru\/server_info\/193.26.217.40:27015","address":"193.26.217.40:27015","version":"47","password":0,"game":{"id":2,"code":"cs16","name":"Counter-Strike 1.6","img":"https:\/\/i.ip-games.ru\/game\/2.png"},"country":{"code":"ru","name":"\u0420\u043e\u0441\u0441\u0438\u044f","img":"https:\/\/i.ip-games.ru\/flags\/ru.png"},"name":"Russian Server | IP-Games.ru","ping":1,"mod":"public","players":{"now":0,"max":20},"map":{"name":"awp_city","img":"https:\/\/i.ip-games.ru\/map\/2\/awp_city\/1.jpg"},"votes":{"likes":657,"dislikes":2},"rangs":{"rang":24,"grang":46},"vk_group":{"name":"\"IP-Games\" - \u041c\u043e\u043d\u0438\u0442\u043e\u0440\u0438\u043d\u0433 \u0418\u0433\u0440\u043e\u0432\u044b\u0445 \u0421\u0435\u0440\u0432\u0435\u0440\u043e\u0432","url":"ipgamesru","members_count":"1 595","photo":"https:\/\/sun9-19.userapi.com\/c847221\/v847221865\/844a2\/-qUxrWKdu8s.jpg?ava=1","type":"group","UpdateTime":1566000027},"hosting":{"name":"MyArena.ru","url":"https:\/\/ip-games.ru\/hosting\/myarena","ico":"https:\/\/i.ip-games.ru\/favicons\/myarena.png"},"uptime":"100","update":1539794404,"_key":false,"_server":1,"_version":2.2}}
Готовое решение:

Информация о сервере (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.players

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

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

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

Параметры запроса:
  • [server_address] — IP:PORT сервера
  • [your_secret_key] — ваш API-ключ
Пример ответа:
{"result":[{"name":"\u0411\u0435\u043b\u043a\u0430","score":4,"ping":null,"time":"01:02:00"},{"name":"adisei","score":2,"ping":null,"time":"00:23:59"},{"name":"I'M NOOB (SILVER 1)","score":1,"ping":null,"time":"00:09:06"}]}
Готовое решение:

Вывод игроков на сервере (PHP) [RAR] / Автор: -

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":"Lexa","voted":1,"ip":"178.206.9.226","date":1491846677},{"username":null,"voted":1,"ip":"176.52.73.78","date":1491834454}]
Пояснение к ответу:
  • 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":28,"name":"Advens.ru"},{"hosting_id":50,"name":"Srvgame.ru"},{"hosting_id":26,"name":"OurServers.ru"},{"hosting_id":65,"name":"FunHost.su"}]
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 — режим разработчика
Пример ответа:
{"result":["91.211.117.88:27050","91.211.117.132:28000","91.211.117.88:27015","91.211.117.88:27017","91.211.117.88:27000","91.211.117.88:27039","91.211.117.88:27028","91.211.117.132:27129","91.211.117.132:28001","91.211.117.132:27028","91.211.117.88:27700","91.211.117.132:28008"]}
hosting.serverAdd

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

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

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

Параметры запроса (POST данные):
Параметры запроса (GET данные):
Пример ответа:
[{"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 - если false, указывается причина ошибки
Готовое решение:

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

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

Платные услуги мониторинга

Скидки для партнеров

скидка для партнеров

services.get

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

Параметры запроса (GET данные):
  • [your_secret_key] — ваш API-ключ
Пример запроса:

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

Пример ответа:
{"result":[{"services_id":9,"name":"\u0422\u041e\u041f-\u043f\u0440\u0435\u0434\u043b\u043e\u0436\u0435\u043d\u0438\u0435","description":"\u0422\u043e\u043f \u043d\u0430 30 \u0434\u043d\u0435\u0439, \u043f\u0440\u0435\u043c\u0438\u0443\u043c \u043d\u0430 30 \u0434\u043d\u0435\u0439 +100 \u0433\u043e\u043b\u043e\u0441\u043e\u0432 \u0432 \u043f\u043e\u0434\u0430\u0440\u043e\u043a!","partner_price":233},{"services_id":17,"name":"\u0411\u044b\u0441\u0442\u0440\u044b\u0439 \u0441\u0442\u0430\u0440\u0442","description":"\u0422\u043e\u043f \u043d\u0430 7 \u0434\u043d\u0435\u0439 \u043f\u0440\u0435\u043c\u0438\u0443\u043c \u043d\u0430 7 \u0434\u043d\u0435\u0439 +100 \u0433\u043e\u043b\u043e\u0441\u043e\u0432!","partner_price":113},{"services_id":7,"name":"500 \u0433\u043e\u043b\u043e\u0441\u043e\u0432","description":"\u0413\u043e\u043b\u043e\u0441\u0430 \u043f\u043e\u0434\u043d\u0438\u043c\u0430\u044e\u0442 \u043f\u043e\u0437\u0438\u0446\u0438\u044e \u0441\u0435\u0440\u0432\u0435\u0440\u0430 \u0432 \u043f\u043e\u0438\u0441\u043a\u0435, \u0447\u0435\u043c \u0431\u043e\u043b\u044c\u0448\u0435 \u0433\u043e\u043b\u043e\u0441\u043e\u0432, \u0442\u0435\u043c \u0432\u044b\u0448\u0435 \u0441\u0435\u0440\u0432\u0435\u0440.","partner_price":268}]}
Готовое решение:

http://demo.api.ip-games.ru/index.php

Покупка услуг через API (PHP) / Автор: -

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

services.balance

Узнаем баланс аккаунта. Пополнить счет можно перейдя по этой ссылке.

Параметры запроса (GET данные):
  • [your_secret_key] — ваш API-ключ
Пример запроса:

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

Пример ответа:
{"result":{"partner_name":"admin","balance":317,"partner_price":"10"}}
Пояснение к ответу:
  • partner_price — скидка аккаунта в процентах, таблица скидок для партнеров
services.order

Проверка выбранной услуги (подтверждение)

Параметры запроса (GET данные):
  • [your_secret_key] — ваш API-ключ
  • [services_id] — уникальный идентификатор (элемент id из функции services.get)
  • address — IP:PORT сервера
  • start_payment — Для покупки платной услуги, должно быть не пустым, обычно "True".
  • test_mode — "True" = активирует тестовый режим (средства не будут списаны), "False" = отключает тестовый режим
  • dev=1 — режим разработчика
Пример запроса:

https://api.ip-games.ru/method/services.order?services_id=[services_id]&key=[your_secret_key]

Пример ответа:
{"result":{"status":true,"test_mode":1}}
Готовое решение:

http://demo.api.ip-games.ru/index.php

Покупка услуг через API (PHP) / Автор: -

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

services.logs

Проверка выбранной услуги (подтверждение)

Параметры запроса (GET данные):
  • [your_secret_key] — ваш API-ключ
Пример запроса:

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

Пример ответа:
{"result":[{"status":"paid","address":"127.0.0.1:12345","services_id":19,"services_amount":102,"date":1513779162},{"status":"paid","address":"127.0.0.1:54321","services_id":9,"services_amount":241,"date":1513770021}]}
Пояснение к ответу:
  • status — paid = оплачен

Список игр

games.all

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

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

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

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