Для розробників

B2B API Інтеграція

VatraMC надає REST API для власників серверів.

Авторизація (API Key)

Усі запити до API повинні містити HTTP-заголовок Authorization. Свій унікальний ключ ви можете згенерувати у Кабінеті VatraMC.

Authorization: Bearer vatra_ваш_ключ

Доступні Ендпоінти

GEThttps://vatramc.com/api/v1/server/{IP}/votes

Отримання ТОП-10 голосуючих за поточний та минулий місяць, а також 10 останніх голосів у реальному часі.

{
  "success": true,
  "votes_data": {
    "current_month_top": [
      { "username": "DantanUA", "vote_count": 35 },
      { "username": "Player2", "vote_count": 12 }
    ],
    "previous_month_top": [ ... ],
    "recent_votes": [
      { "username": "DantanUA", "date": "2026-10-30T14:00:00.000Z" }
    ]
  }
}

GEThttps://vatramc.com/api/v1/my-stats

Глобальна статистика ваших серверів: рейтинг, аптайм (%), кількість коментарів та загальні голоси.

{
  "success": true,
  "my_servers": [
    {
      "name": "HomeLand Survival",
      "rank": 1,
      "stats": {
        "uptime_percent": 99.4,
        "comments": 14,
        "votes_month": 350
      }
    }
  ]
}

GEThttps://vatramc.com/api/v1/server/{IP}/all-votes?pg=1

{
  "success": true,
  "server_name": "HomeLand Survival",
  "total_votes": 1250,
  "current_page": 1,
  "per_page": 100,
  "total_pages": 13,
  "votes": [
    {
      "username": "DantanUA",
      "IP": "***.***.***.***",
      "date": "2026-10-30 14:00:00",
      "vote_points": 1
    },
    {
      "username": "MIKSER",
      "IP": "***.***.***.***",
      "date": "2026-10-29 21:15:30",
      "vote_points": 1
    }
  ]
}