/api/catalogКаталог отелей
Выдача объектов с фильтрами, сортировкой и пагинацией.
API / REST
Для разработчиков
API ESB: реальные маршруты и единая спецификация
Страница дает быстрый обзор контура интеграции. Полные схемы запросов, ответов, параметров и ошибок генерируются автоматически и доступны в интерактивном Swagger UI.
HTTPS REST Request
curl -X GET https://api.esb.ru/api/catalog?location=МоскваAuthorization: Bearer <token>
Accept: application/json
СпецификацияOpenAPI 3.0 / Swagger
АвторизацияLaravel Sanctum (Bearer)
Формат обменаJSON over HTTPS
Безопасность
Sanctum Bearer Token
Клиент получает токен через маршрут входа. Защищённые запросы передают его в заголовке Authorization. Права доступа проверяются по назначенной роли (гость, отельер, администратор).
Заголовок запроса
Authorization: Bearer <personal_access_token>
Основные маршруты
/api/auth/loginАвторизация
Вход пользователя и выпуск Sanctum Bearer токена.
/api/user/bonusesБонусный баланс
Текущий баланс и история бонусных операций клиента.
/api/user/referralsРеферальная сеть
Персональная ссылка, аналитика переходов и приглашённые.
/api/bookingsСоздание брони
Оформление заказа на бронирование для авторизованного клиента.
/api/cabinet/dashboardКабинет партнёра
Сводные показатели и статистика бронирований отельера.
Структура ответа
JSON over HTTPS
Все методы API возвращают унифицированную структуру с полями status, data и опциональным блоком meta для постраничной навигации.
GET /api/catalog — 200 OKapplication/json
{
"status": "success",
"data": [
{
"id": "alean_10482",
"name": "Гранд Отель Поляна",
"stars": 5,
"locality": "Сочи",
"price": 18500,
"rating": 4.9,
"available": true
}
],
"meta": {
"current_page": 1,
"per_page": 20,
"total": 142
}
}Источник истины — Swagger UI
Точные обязательные поля, коды 401/403/422/500 и схемы ответов генерируются автоматически из исходного кода backend. Используйте полную интерактивную документацию для интеграции.
Перейти к полной документации Swagger →