Интеграция

Назначение

Интеграция — API-ключи для доступа к API PMS с внешних систем (собственные каталоги, мобильные приложения, партнёрские сайты). По ключу можно получать данные об объектах, типах номеров, доступности и ценах, создавать бронирования, получать список бронирований. Ключи создаются в этом разделе и передаются в запросах к API.

Основные действия

• Создать ключ — укажите название ключа (для себя, чтобы отличать от других) и нажмите «Создать». Скопируйте выданный ключ и храните его в безопасном месте — повторно полный ключ может не отображаться.
• Использование — в запросах к API передавайте ключ в заголовке X-API-Key или в параметре api_key. Документация API доступна на основном сайте проекта (pms1.ru) или в разделе docs.
• Удалить ключ — при компрометации или ненадобности ключ можно удалить; запросы с этим ключом перестанут проходить.

Что можно делать через API

Получение каталога объектов и номеров, проверка доступности по датам, получение цен, создание бронирования, получение списка бронирований. Авторизация по ключу даёт доступ в рамках вашего аккаунта отельера (ваши объекты и бронирования). Для авторизации гостей на сторонних сайтах используется отдельный сервис (например auth.zabronit.ru для каталога zabronit.ru).

Важные нюансы

Не передавайте API-ключ в открытом виде на клиенте (например в JavaScript на публичной странице). Используйте ключ только на сервере вашего приложения или в доверенных средах. При утечке ключа удалите его в панели и создайте новый.