REST API · v1
Сервисы API
Бэкенд приложения «Мой Магас»: новости, объявления, обращения жителей, аккаунты и уведомления.
Базовый URL /api
Проверяем сервисы…
живой запрос к API
живой запрос к API
Эндпоинты
| Метод | Путь | Авторизация | Описание |
|---|---|---|---|
| GET | /api/health | — | Проверка живости сервиса |
| GET | /api/news | — | Список новостей города |
| GET | /api/news/:id | — | Одна новость |
| GET | /api/announcements | — | Объявления администрации |
| GET | /api/appeals | — | Публичные обращения |
| GET | /api/appeals?mine=1 | Bearer | Мои обращения |
| GET | /api/appeals/:id | — | Обращение по ID |
| POST | /api/appeals | Bearer | Создать обращение (номер присваивается сервером) |
| POST | /api/auth/register | — | Регистрация жителя |
| POST | /api/auth/login | — | Вход, возвращает JWT |
| GET | /api/auth/me | Bearer | Профиль текущего пользователя |
| PATCH | /api/auth/me | Bearer | Обновление профиля |
| POST | /api/auth/reset | — | Сброс пароля |
| GET | /api/notifications | Bearer | Уведомления пользователя |
Публичные GET-эндпоинты можно открыть прямо в браузере — кликните по подсвеченному пути.