Монікор

Зовнішній API

Інструменти

Зовнішній API

Дозволяє отримати публічні дані вашого сервера - рейтинг, голоси, вподобайки, відгуки - через захищений API-ключ. Ліміт: 20 запитів за хвилину.

Endpoint

GET /api/external/server/

Авторизація

API-ключ передається у заголовку кожного запиту. Отримати ключ можна в налаштуваннях сервера.

X-Monicore-API-Key: ваш_api_ключ

Query-параметри

За замовчуванням повертаються лише базові поля. Додаткові дані запитуються явно:

votes_todayboolean

Голоси за сьогодні

votes_monthboolean

Голоси за поточний місяць

votes_prev_monthboolean

Голоси за попередній місяць

votes_allboolean

Усі голоси за весь час

likesboolean

Список лайків

commentsboolean

Список коментарів (без відповідей)

Структура відповіді

idnumber

Числовий ID сервера

slugstring

URL-slug сервера

namestring

Назва сервера

ratingfloat

Середній рейтинг (0-5)

created_atdatetime

Дата реєстрації на платформі

votes_todayarrayoptional

Масив об'єктів { user_id, user_nickname, created_at }

votes_montharrayoptional

Масив об'єктів { user_id, user_nickname, created_at }

votes_prev_montharrayoptional

Масив об'єктів { user_id, user_nickname, created_at }

votes_allarrayoptional

Масив об'єктів { user_id, user_nickname, created_at }

likesarrayoptional

Масив об'єктів { user_id, user_nickname, created_at }

commentsarrayoptional

Масив об'єктів { user_id, user_nickname, created_at }

Приклад запиту

GET /api/external/server/
X-Monicore-API-Key: ваш_api_ключ

Приклад відповіді

{
  "id": 42,
  "slug": "my-server",
  "name": "My Server",
  "rating": 4.8,
  "created_at": "2024-01-15T10:30:00Z",
  "votes_today": [
    {
      "user_id": "123456789",
      "user_nickname": "PlayerName",
      "created_at": "2025-03-18T09:00:00Z"
    }
  ],
  "likes": [
    {
      "user_id": "987654321",
      "user_nickname": "AnotherPlayer",
      "created_at": "2025-03-17T20:00:00Z"
    }
  ]
}

Коди помилок

403Forbidden

API-ключ відсутній або невірний

404Not Found

Сервер не знайдено або недоступний

429Too Many Requests

Перевищено ліміт 20 запитів/хв

500Server Error

Внутрішня помилка сервера

Тест API

Надішліть живий запит через ваш API-ключ та отримайте реальну відповідь.