Инструкция для онлайн-сервисов бронирования (OTA) по интеграции с PMS WeRent через открытое API

Вы представляете канал и хотите подключить свой сервис к менеджеру каналов PMS WeRent?

WeRent предоставляет открытое API для обмена данными с OTA (онлайн-туристическими агентствами) — по доступности, ценам, ограничениям и бронированиям.

API позволяет OTA:
  • Получать из PMS WeRent актуальную доступность по датам и квартирам
  • Получать из PMS WeRent цены и ограничения по датам и квартирам
  • Отправлять новые бронирования и отмены этих бронирований в PMS WeRent

Swagger-документация

https://ota-api.werent.me/swagger

Пошаговая инструкция подключения для менеджера OTA

1. Получите доступ

Напишите нам на электронную почту integrations@werent.me
Уточните контактное лицо со своей стороны и предполагаемые сроки интеграции.

В ответном письме вы получите:
  • client_id и client_secret – ваши уникальные идентификаторы
  • api_token – доступ к API тестового аккаунта
  • email и password – доступы в личный кабинет тестового аккаунт
2. Передайте технической команде следующие ссылки:

Swagger-документация (интерактивная инструкция):
https://ota-api.werent.me/swagger
3. После завершения интеграции уведомите менеджера WeRent по почте

Мы проведём базовую проверку доступности, цен, ограничений и бронирований
4. Разместите инструкции для владельцев объектов

После тестирования вы можете:
– Опубликовать инструкцию подключения WeRent на своей платформе
– Получить логотип и краткое описание для отображения на werent.me
5. WeRent добавит ваш канал в список поддерживаемых OTA

Канал появится в интерфейсе системы и будет доступен для подключения владельцами апартаментов и квартир.
Успех! Наши пользователи смогут подключать ваш канал бронирования напрямую в PMS WeRent!

Технические детали

  • REST API по HTTPS
  • Формат: JSON
  • Авторизация: API-ключ
    Authorization: Bearer <ваш_ключ>
  • Формат дат: YYYY-MM-DD
  • Используемые HTTP-методы: GET, POST, PUT, DELETE

Документация для подключения OTA

1. Подключение OTA к WeRent
1.1 Получение учетных данных

Для подключения OTA необходимо получить учетные данные:

  1. OTA отправляет запрос на почту integrations@werent.me для получения client_id и client_secret.
  2. С помощью этих учетных данных OTA выполняет авторизацию по контроллеру:
POST /api/ota/auth
Пример ответа при успешной авторизации:
{    
     "success": true,    
     "tokens": 
  {
        "access_token": "8fbefae8723538c10556b617abee1d85",
        "refresh_token": "b3d23a1226a941ad4f5b1953ab1e63a91b8a30b3e16e8c3f"
    }
} 
  • access_token используется для выполнения запросов к WeRent API (Bearer Token).
  • refresh_token используется для обновления access_token через контроллер:
PUT /api/ota/auth
Примечание: access_token не имеет ограничения по времени жизни (TTL), но при необходимости его можно обновить с помощью refresh_token.

Пользователь WeRent, к аккаунту которого подключается OTA, предоставляет OTA свой аккаунт-токен (Account-Token).
Итог: для выполнения запросов OTA имеет два токена:
  • OTA-access_token — токен OTA
  • Account-Token — токен аккаунта пользователя
2. Выполнение запросов к WeRent API

Каждый запрос OTA должен содержать следующие заголовки:
  • Authorization: Bearer <OTA-access_token>
  • Account-Token: <User account token>

2.1 Синхронизация объектов

  1. Пользователь WeRent передает OTA public_id объектов, которые нужно синхронизировать.
  2. OTA использует public_id для всех запросов к WeRent API.

2.2 Получение доступности

Для получения доступности объектов на год вперед используется:
GET /api/ota/availability
OTA должна запросить доступность с текущей даты на один календарный год вперед для каждого объекта.

2.3 Получение ограничений и цен

Для получения ограничений и цен на объекты на год вперед используется:
GET /api/ota/restrictions
Возвращаемые данные содержат цены, минимальное/максимальное количество ночей, закрытия дат и другие ограничения.

2.4 Создание, изменение и отмена бронирований

Для работы с бронированиями используется:
POST /api/ota/booking      — создание брони
PUT  /api/ota/booking      — изменение брони
DELETE /api/ota/booking    — отмена брони
Все операции бронирования должны использовать Account-Token для идентификации пользователя, к которому относится бронь.

2.5 Периодическое обновление данных
Для поддержания актуальности цен и ограничений OTA обязано периодически опрашивать WeRent API, чтобы получать обновления.
3. Ограничения по количеству запросов
Лимиты на количество запросов к API WeRent:
Интервал
Лимит запросов
10 секунд
25
5 минут
300
1 час
1000
1 день
10000
Примечание: Все превышения лимитов должны корректно обрабатываться OTA.

Поддержка

Если у вас возникли вопросы или нужна помощь с интеграцией, напишите нам:
📩 integrations@werent.me