REST API · v1
Сервисы API
Бэкенд приложения «Мой Магас»: новости, объявления, обращения жителей, аккаунты и уведомления.
Базовый URL /api
Проверяем сервисы…
живой запрос к API
живой запрос к API
Мобильные версии проекта
Android 1.0.1
Тестовая APK без подписи владельца. Это архив для проверки сборки, пока не установочный релиз.
Скачать APK для QA ↗iOS 1.0.1
Актуальный Flutter/Xcode проект для сборки на Mac. IPA пока нет: нужны Apple Developer, подпись и проверка на устройстве.
Скачать исходники iOS ↗Оба файла относятся к версии проекта 1.0.1. Посмотреть план выпуска.
Эндпоинты
Прокрутите таблицу вправо, чтобы увидеть описания →
| Метод | Путь | Авторизация | Описание |
|---|---|---|---|
| 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-эндпоинты можно открыть прямо в браузере — кликните по подсвеченному пути.