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

Ключевые адреса API для интеграции с платформой ExBike

Спецификация OpenAPI доступна по адресу: /api/docs

Это сокращённый внешний контур: публичный API и отдельные адреса запросов для партнёрской интеграции. Кабинетные маршруты с сессионной авторизацией и внутренние обработчики ролей не считаются внешним контрактом, пока не описаны здесь явно.

Во время перехода английские `/api/*` пути сохранены для совместимости, но новым интеграциям стоит брать транслитерированные адреса ниже. Исходная спецификация в рабочем окружении доступна только авторизованным аккаунтам ролей `ADMIN`, `PARTNER` или `GOV`.

GET/api/proverki?query={query}&format=canonical

Проверка по VIN, серийному номеру, номеру рамы или ID. Для новых интеграций рекомендуется параметр `format=canonical`; режим `dual` сохранён по умолчанию для совместимости.

GET/api/statistika

Общая статистика по количеству техники и проверок.

GET/api/poisk?q={query}

Поиск по мастерским, маршрутам, клубам, школам и событиям.

GET/api/masterskie

Список мастерских. Фильтры: `city`, `type`, `vehicleType`, `verified`; для расстояния и поиска рядом можно передать `lat` и `lng`. В ответе есть `topServices`, `liveStatus` и выдача с учётом дистанции.

GET/api/marshruty

Список маршрутов для катания.

GET/api/kluby

Список клубов и сообществ.

GET/api/shkoly

Список мотошкол.

GET/api/sobytiya

Список событий и мероприятий.

GET/api/raydery

Публичный поиск райдеров. Фильтры: `city`, `style`, `level`.

GET/api/dostizheniyaНужен вход

Бейджи текущего пользователя.

GET/api/izbrannoeНужен вход

Избранное текущего пользователя.

GET/api/uvedomleniyaНужен вход

Уведомления текущего пользователя.

GET/api/priglasheniyaНужен вход

Реферальный код и ссылка.

POST/api/auth/zabyli-parol

Отправка ссылки для сброса пароля на эл. почту.

POST/api/zhalobyНужен вход

Подача жалобы на пользователя или контент.

GET/api/zdorove

Состояние сервера, базы данных и Redis.