Окружения и доступы

Hostme предоставляет два контура: боевой (production) и тестовый (QA). Все интеграции рекомендуется сначала отлаживать на QA, и только затем переключать на прод.

Базовые URL

Все пути в документации относительны к базовому URL. Например, эндпоинт /api/rsv/admin/restaurants/{restaurantId}/availability на проде — это https://api.hostmeapp.com/api/rsv/admin/restaurants/123/availability.

Получение токена

Токен выдаётся на базовом домене API по POST /Token (form-urlencoded):

Партнёрам достаточно grant_type=password, username, password — client_id и scope не нужны. Подробнее — в разделе Аутентификация.

Про swagger. В спецификации OAuth2 объявлен с tokenUrl: https://service.hostmeapp.com/token (официальный сервер авторизации), но на практике токен принимается и на базовом домене API ({API_BASE}/Token) — этот путь и рекомендуется для интеграций.

Как получить доступ

Для интеграции вам понадобятся:

1. Учётные данные для получения токена (логин/пароль сервисной учётной записи или партнёрский доступ — выдаёт команда Hostme).
2. Идентификатор ресторана (restaurantId) — числовой ID ресторана, с которым работаете. Список доступных ресторанов возвращает GET /api/core/admin/account/me (см. Аутентификация).
3. Для партнёрских приложений — appId приложения (см. Регистрация приложения).

Доступ к API, сервисные учётные записи и партнёрские идентификаторы выдаются по запросу к команде Hostme. Эта документация описывает, как использовать уже выданный доступ.

Рекомендации по средам

• Не храните токены и учётные данные в коде. Используйте секреты/переменные окружения.
• Тестируйте на QA. Данные QA изолированы от прод-данных ресторанов.
• Разделяйте конфигурацию. Базовый URL, token endpoint и restaurantId должны быть параметрами окружения, а не константами.