Skip to main content

Base URL

https://makbool.ru/api/v1

Аутентификация

Большинство эндпоинтов требуют JWT-токен пользователя. Исключение — POST /errors, который принимает API Key проекта в теле запроса.

Получить токен

POST /auth/login
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "your_password"
}
{
  "access_token": "eyJhbGciOiJIUzI1NiJ9...",
  "token_type": "bearer"
}

Использовать токен

GET /projects
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...

Формат ответов

Все ответы в формате JSON. Список объектов возвращается в обёртке:
{
  "items": [...],
  "total": 42,
  "page": 1,
  "size": 20
}

Коды ошибок

КодЗначение
400Неверный запрос — проверьте тело запроса
401Не авторизован — передайте токен или API Key
403Нет доступа
404Ресурс не найден
429Превышен лимит ошибок плана
500Ошибка сервера

Документация Swagger

Интерактивная документация со всеми эндпоинтами доступна по адресу:
https://makbool.ru/api/docs