Игровой мониторинг Servers.Fun

Серверов

3243

Игроков

36356

Введение

Для доступа к любому методу API используется уникальный идентификатор (<IDENTIFIER>), он же - ID сервера, либо адрес сервера (IP:PORT).

Что бы узнать ID сервера воспользуйтесь поиском вверху страницы - введите название интересующего сервера, из предоставленного списка выберите нужный, и перейдите на страницу сервера. Открыв адресную строку Вы увидите URL похожий на этот "https://servers.fun/samp/absolut-roleplei-platinym-gta-samp_ru/14370", цифры в конце строки и есть ID сервера.


Для вызова API используется следующая структура: https://servers.fun/api/<METHOD>/<IDENTIFIER>?<PARAMS>

  • <METHOD> - метод API (см. примеры ниже);
  • <IDENTIFIER> - идентификатор сервера (см. выше);
  • <PARAMS> - параметры вызова метода (см. примеры ниже).

Для более подробной информации воспользуйтесь одним из примером в конце страницы.

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

Получение информации используя идентификатор сервера:

https://servers.fun/api/servers/<IDENTIFIER>?forJavaScript=true

<!-- Примеры использования: --> https://servers.fun/api/servers/14370 https://servers.fun/api/servers/95.213.255.83:7771 https://servers.fun/api/servers/14370?forJavaScript=true https://servers.fun/api/servers/95.213.255.83:7771?forJavaScript=true

<IDENTIFIER> - идентификатор сервера, которым может выступать ID сервера в мониторинге или же его адрес (IP:PORT);
forJavaScript - возвращает данные в виде JavaScript переменой (см. пример в конце).


Возвращаемые данные:
Имя Тип данных Пример Описание
id integer 14370 Идентификатор (ID)
ip string 95.213.255.83 IP адрес
port integer 7771 Порт
title string Абсолют РолеПлей 1 | Платинум | GTA-SAMP.RU Заголовок сервера
gamemode string Russia/RPG/RolePlay/RP Мод
language string Russian/Русский/русский Язык
version string 0.3.7-R2 Версия
site string www.gta-samp.ru Сайт
players array - Массив с информацией о игроках
number integer 902 Количество игроков онлайн
maximum integer 1000 Количество слотов
averageNumber integer 480 Среднее количество игроков
maximumNumber integer 1000 Максимальное количество игроков
game array - Массив с информацией о игре
id integer 1 ID игры
title string SAMP Название игры
rating float 2.7 Рейтинг
found boolean true Найден ли сервер
onlineStatus boolean true Онлайн ли сервер
createdAt string 2018-09-17 21:55:09 Дата добавления сервера в мониторинг

Пример возвращаемых данных:
// Запрос: https://servers.fun/api/servers/14370
{
    "id": 14370,
    "ip": "95.213.255.83",
    "port": 7771,
    "title": "Абсолют РолеПлей 1 | Платинум | GTA-SAMP.RU",
    "gamemode": "Russia/RPG/RolePlay/RP",
    "language": "Russian/Русский/русский",
    "version": "0.3.7-R2",
    "site": "www.gta-samp.ru",
    "players": {
        "number": 902,
        "maximum": 1000,
        "averageNumber": 0,
        "maximumNumber": 0
    },
    "game": {
        "id": 1,
        "title": "SAMP"
    },
    "rating": 2.7,
    "found": true,
    "onlineStatus": true,
    "createdAt": "2018-09-17 21:55:09",
}

Пример возвращаемых данных #2:
// Запрос: https://servers.fun/api/servers/14370?forJavaScript=true
var server = JSON.parse('{
    "id": 14370,
    "ip": "95.213.255.83",
    "port": 7771,
    "title": "Абсолют РолеПлей 1 | Платинум | GTA-SAMP.RU",
    "gamemode": "Russia/RPG/RolePlay/RP",
    "language": "Russian/Русский/русский",
    "version": "0.3.7-R2",
    "site": "www.gta-samp.ru",
    "players": {
        "number": 902,
        "maximum": 1000,
        "averageNumber": 0,
        "maximumNumber": 0
    },
    "game": {
        "id": 1,
        "title": "SAMP"
    },
    "rating": 2.7,
    "found": true,
    "onlineStatus": true,
    "createdAt": "2018-09-17 21:55:09",
}');

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

Получение статистики используя идентификатор сервера:

https://servers.fun/api/statistics/<IDENTIFIER>?per=(day/week/month)&forJavaScript=true

<!-- Примеры использования: --> https://servers.fun/api/statistics/14370?per=day https://servers.fun/api/statistics/95.213.255.83:7771?per=week https://servers.fun/api/statistics/14370?per=month&forJavaScript=true https://servers.fun/api/statistics/95.213.255.83:7771?per=day&forJavaScript=true

<IDENTIFIER> - идентификатор сервера, которым может выступать ID сервера в мониторинге или же его адрес (IP:PORT);
per - указывает тип возвращаемой статистики, может принимать одно из следующих значений: day, week, month;
forJavaScript - возвращает данные в виде JavaScript переменой (см. пример в конце).


Имя Тип данных Пример Описание
serverId integer 14370 Идентификатор (ID) сервера
per string day Период возвращаемой статистики
averageOnline integer 527 Средний онлайн за выбранный период
maximumOnline integer 1000 Максимальный онлайн за выбранный период
list array Статистика
Возвращаемые данные:

Возвращаемые данные массива list при &per=day:
Имя Тип данных Пример Описание
id integer 2909512 Идентификатор (ID) статистики
players integer 485 Количество игроков
createdAt string 2018-09-17 21:55:09 Дата создания статистики

Возвращаемые данные массива list при &per=week / &per=month:
Имя Тип данных Пример Описание
id integer 2909512 Идентификатор (ID) статистики
averageOnline integer 520 Средний онлайн, в день
maximumOnline integer 829 Максимальный онлайн, в день
createdAt string 2018-09-17 21:55:09 Дата создания статистики

Пример возвращаемых данных:
// Запрос: https://servers.fun/api/statistics/3242?per=day
{
    "serverId": 3242,
    "per": "day",
    "averageOnline": 178,
    "maximumOnline": 388,
    "list": [
        // ...................
        {"id": 3986987, "players": 167, "createdAt": "2018-09-21 10:00:32"},
        {"id": 3983195, "players": 155, "createdAt": "2018-09-21 09:45:32"},
        {"id": 3979444, "players": 153, "createdAt": "2018-09-21 09:30:32"},
        {"id": 3975763, "players": 140, "createdAt": "2018-09-21 09:15:34"},
        // ...................
    ]
}

Пример возвращаемых данных #2:
// Запрос: https://servers.fun/api/statistics/3242?per=month&forJavaScript=true
var statistic = JSON.parse('{
    "serverId": 3242,
    "per": "month",
    "averageOnline": 195,
    "maximumOnline": 488,
    "list": [
        // ...................
        {"id": 53419, "averageOnline": 178, "maximumOnline": 388, "createdAt": "2018-09-20 13:00:30"},
        {"id": 48611, "averageOnline": 147, "maximumOnline": 350, "createdAt": "2018-09-19 13:00:33"},
        {"id": 47259, "averageOnline": 152, "maximumOnline": 276, "createdAt": "2018-09-18 13:00:32"},
        {"id": 42295, "averageOnline": 240, "maximumOnline": 444, "createdAt": "2018-09-17 12:15:14"},
        // ...................
    ]
}');

Информация о игроках

Получение информации о игроках:

https://servers.fun/api/players/<IDENTIFIER>?type=(online/top)&forJavaScript=true

<!-- Примеры использования: --> https://servers.fun/api/players/14370?type=online https://servers.fun/api/players/95.213.255.83:7771?type=online https://servers.fun/api/players/14370?type=top&forJavaScript=true

<IDENTIFIER> - идентификатор сервера, которым может выступать ID сервера в мониторинге или же его адрес (IP:PORT);
type - указывает тип возвращаемой информации, может принимать одно из следующих значений: online (список игроков онлайн), top (топ-100 игроков по количеству отыгранного времени);
forJavaScript - возвращает данные в виде JavaScript переменой (см. пример в конце).


Возвращаемые данные:
Имя Тип данных Пример Описание
serverId integer 14370 Идентификатор (ID) сервера
type string online Тип информации о игроках
list array Список игроков

Возвращаемые данные массива list при &type=online / &type=top:
Имя Тип данных Пример Описание
id integer 58282 Идентификатор (ID) игрока
nickname string brebvix Никнейм игрока
playedMinutes string 120 Количество отыгранных минут на сервере
lastActivity string 2018-09-17 12:15:14 Дата последнего посещения сервера

Пример возвращаемых данных:
// Запрос: https://servers.fun/api/players/16896?type=online
{
    "serverId": 16896,
    "type": "online",
    "list": [
        // ...................
        {"id": "Harry_Odebrecht", "nickname": "Harry_Odebrecht", "playedMinutes": 30, "lastActivity": "2018-09-21 00:00:27"},
        {"id": "Felipe_Hobbs", "nickname": "Felipe_Hobbs", "playedMinutes": 15, "lastActivity": "2018-09-21 00:00:25"},
        {"id": "Terry_Harper", "nickname": "Terry_Harper", "playedMinutes": 15, "lastActivity": "2018-09-21 00:00:21"},
        {"id": "Kenny_Franchetti", "nickname": "Kenny_Franchetti", "playedMinutes": 15, "lastActivity": "2018-09-21 00:00:20"},
        // ...................
    ]
}

Пример возвращаемых данных #2:
// Запрос: https://servers.fun/api/players/16896?type=top&forJavaScript=true
var players = JSON.parse('{
    "serverId": 16896,
    "type": "top",
    "list": [
        // ...................
        {"id": "Harry_Odebrecht", "nickname": "Rubens_Junior", "playedMinutes": 165, "lastActivity": "2018-09-21 00:00:27"},
        {"id": "Felipe_Hobbs", "nickname": "Griffley_Wakabayashi", "playedMinutes": 140, "lastActivity": "2018-09-21 00:00:27"},
        {"id": "Terry_Harper", "nickname": "Lukaku_Hobbs", "playedMinutes": 90, "lastActivity": "2018-09-21 00:00:27"},
        {"id": "Kenny_Franchetti", "nickname": "Calvin_Galaxy", "playedMinutes": 75, "lastActivity": "2018-09-21 00:00:27"},
        // ...................
    ]
}');

Примеры использования API

Для лучшего понимания работы API Вы можете использовать любой из перечисленных примеров: