Рестораны
Поиск ресторанов, получение информации, расписание работы и проверка наличия свободных столов.
Структура данных ресторана
Каждый ресторан представлен объектом RestaurantExternalDto:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
id | int64 | да | Уникальный ID ресторана в GuestMe |
name | string | да | Название ресторана |
status | enum | да | ACTIVE, INACTIVE или DELETED |
description | string | нет | Описание ресторана |
address | object | да | Адрес (country, city, street, home, point) |
info | object | да | Контакты (phone, site, telegram, vk, iikoUid) |
properties | object | да | Свойства (phoneConfirmationEnabled, guestAcquisitionChannelEnabled) |
Поиск ресторанов
Постраничный поиск ресторанов по названию и адресу.
curl "https://backend.guestme.ru/api/v1/external/restaurant?search=итальянский&page=0&size=10" \
-H "Authorization: Bearer TOKEN"
Получение ресторана по ID
curl "https://backend.guestme.ru/api/v1/external/restaurant/1001" \
-H "Authorization: Bearer TOKEN"
Поиск по ID партнёрской системы
В качестве {id} передаётся UID ресторана из POS-системы (iiko, r_keeper), например 123-456-789.
curl "https://backend.guestme.ru/api/v1/external/restaurant/find/partner/abc-123-def" \
-H "Authorization: Bearer TOKEN"
Свободные столы
Количество свободных столов на заданную дату и число гостей.
curl "https://backend.guestme.ru/api/v1/external/restaurant/1001/table/free/count?date=2025-06-15T19:00:00Z&persons=2" \
-H "Authorization: Bearer TOKEN"
Расписание ресторана
Расписание возвращается в виде массива RestaurantScheduleGroupDto. Каждая запись содержит день недели, тип расписания и временные интервалы.
Типы расписания
| Тип | Описание |
|---|---|
RESTAURANT | Часы работы ресторана |
BOOKING | Часы приёма бронирований (могут отличаться от часов работы) |
curl "https://backend.guestme.ru/api/v1/external/restaurant/1001/schedule" \
-H "Authorization: Bearer TOKEN"
Проверка доступности
Перед созданием бронирования убедитесь, что свойство guestAcquisitionChannelEnabled ресторана равно true. Это означает, что ресторан подключил канал привлечения гостей и готов принимать бронирования через API.