API MCSTATS

Бесплатное публичное API для проверки Minecraft серверов. Не требует ключей и регистрации.

Попробовать

Введите адрес сервера и нажмите «Проверить». Ответ появится ниже.

// Нажмите «Проверить» чтобы выполнить запрос

Эндпоинт

GET /api/v1/check?host={host}&port={port}

Параметры

Параметр	Тип	Обязательный	Описание
host	string	Да	IP адрес или домен сервера
port	number	Нет	Порт (по умолчанию 25565)

Пример ответа

{
  "success": true,
  "host": "mc.hypixel.net",
  "port": 25565,
  "online": true,
  "players": 45000,
  "maxPlayers": 50000,
  "latency": 45,
  "version": "1.20.4",
  "motd": "Hypixel Network"
}

Если сервер недоступен:

{
  "success": false,
  "host": "192.168.1.1",
  "port": 25565,
  "online": false,
  "players": 0,
  "maxPlayers": 0,
  "latency": null,
  "version": null,
  "motd": null
}

Примеры кода

cURL

curl "https://mcstats.ru/api/v1/check?host=mc.hypixel.net&port=25565"

JavaScript (fetch)

const res = await fetch("https://mcstats.ru/api/v1/check?host=mc.hypixel.net&port=25565");
const data = await res.json();

if (data.success) {
  console.log(`${data.players}/${data.maxPlayers} онлайн`);
} else {
  console.log("Сервер офлайн");
}

Rate Limits

Максимум 30 запросов в минуту с одного IP адреса.

При превышении лимита API возвращает HTTP 429 и сообщение об ошибке. Лимит обновляется каждую минуту.

Ошибки

HTTP	Код ошибки	Описание
400	missing_host	Не передан обязательный параметр host
400	invalid_port	Порт вне диапазона 1-65535
429	rate_limit_exceeded	Превышен лимит 30 запросов/мин