Демоверсия

API размещения

API размещения для отелей, апартаментов и жилья для отдыха

API размещения доставляет на ваш сайт бронирования любое жильё: номера отелей, сервисные апартаменты, дома для отдыха, хостелы и гостевые дома. На этой странице разбираются данные, из которых состоит проживание, правила, которыми аренда отличается от отелей, и то, как PHPTRAVELS продаёт ваши объекты и фонд поставщиков в одном поиске.

  • Объект, юнит, тариф, календарь
  • Минимальный срок и сборы
  • Окна отмены
  • Свой фонд и API-поставщики

Модель данных

Четыре уровня внутри любого проживания

Будь то отель на 300 номеров или один дом на пляже, API размещения описывает его одними и теми же четырьмя вложенными уровнями. Каждый уровень отвечает на свой вопрос, который гость задаёт перед бронированием.

01Объект

Само место: название, тип, адрес и положение на карте, фотографии, удобства, звёздность или рейтинг качества, правила проживания и время заезда.

property_id · type · address · geo · photos · amenities · check_in_from

02Номер или юнит

То, что реально бронируется: категория номера, целая квартира или койка в общем номере, с площадью, кроватями и максимальным числом гостей.

unit_id · beds · size_m2 · max_adults · max_children

03Тариф

Как продаётся этот юнит: питание, условия отмены, условия оплаты и кто может его бронировать, например все или только агенты.

rate_plan_id · board · cancel_policy · payment · channel

04Доступность

Одна строка на ночь: цена, остаток юнитов, минимальный срок проживания и можно ли в этот день заехать или выехать.

date · price · units_left · min_stay · closed_to_arrival

Здание, номер, ценник и календарь, нарисованные как отдельные наложенные слои одного объявления о проживании

PHPTRAVELS называет свой модуль размещения Stays, потому что одна и та же модель охватывает гораздо больше, чем отели. Объект содержит юниты, юнит продаётся по одному или нескольким тарифам, а у каждого тарифа есть календарь цен и доступности по ночам. Если эти четыре уровня выстроены верно, место в хостеле, люкс в отеле и вилла с тремя спальнями укладываются в один и тот же поиск и оформление заказа.

Поставщики называют уровни по-разному, а некоторые объединяют два из них, но структура всегда на месте. Отели приводит каждый источник к ней, и гость видит единообразную страницу.

Ночь за ночью

Календарь доступности решает, продастся ли проживание

Любой API размещения заканчивается календарём. Поиск возвращает объект, только если каждая ночь запрошенного периода свободна, имеет цену и разрешена правилами проживания.

Двухспальные апартаменты · Стандартный тарифНоябрь 2026 · Цена за ночь
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • Свободно, цена за ночь
  • Уже забронировано
  • Закрыто владельцем
  • Минимальный срок при заезде в этот день
  • Заезд закрыт

Условные данные, упрощено

  • Цены указаны за ночьИтог за проживание равен сумме по каждой ночи, поэтому пятница и суббота по выходному тарифу стоят дороже двух будних дней. Цены по дням и сезонам хранятся в календаре, а не в объекте.
  • Правила минимального срокаМинимум в три ночи при заезде в пятницу скрывает юнит из поиска на две ночи. Аренда использует такие правила гораздо чаще отелей, нередко строже по выходным и в высокий сезон.
  • Заезд или выезд закрытНочь может быть доступна в составе более длинного проживания, но не как первая или последняя. Так работают дни смены гостей в домах для отдыха.
  • Закрытые ночи и стоп-сейлВладельцы закрывают даты для личного пользования или ремонта, а стоп-сейл мгновенно снимает юнит с продажи. Любая закрытая ночь внутри запрошенных дат убирает юнит из выдачи.

Не всякое жильё — отель

Отели, апартаменты и аренда для отдыха

Модель данных общая, но каждый вид жилья заполняет её по-своему. Вот различия, которые должен учитывать ваш процесс бронирования, если вы продаёте не только номера отелей.

Отели

Включая хостелы и гостевые дома

Что бронируется
Категория номера с множеством одинаковых номеров или койка в общем номере.
Цена
Цена за ночь по номеру и питанию; дополнительные взрослые или дети могут её менять.
Правила проживания
Минимальный срок только на пиковые даты; большинство ночей можно бронировать по одной.
Сборы и депозиты
Городской или туристический налог, иногда курортный сбор, который платят на месте.
Заезд
Круглосуточная или обслуживаемая стойка; достаточно времени заезда в ваучере.
Типичный источник
Бэдбанки и оптовики, прямые контракты, channel-менеджеры.

Сервисные апартаменты

Апарт-отели и городские квартиры

Что бронируется
Тип юнита, часто с кухней и отдельными спальнями.
Цена
Цена за ночь за юнит, для долгого проживания есть недельные и месячные цены.
Правила проживания
Минимальный срок встречается часто, а долгое проживание составляет большую часть спроса.
Сборы и депозиты
Плата за уборку за проживание и возвращаемый депозит — обычное дело.
Заезд
Часы работы ресепшена разные; для позднего заезда нужны сейф с ключом или код.
Типичный источник
Channel-менеджеры, прямые контракты и некоторые оптовики.

Аренда для отдыха

Дома, виллы и коттеджи

Что бронируется
Конкретный дом. Обычно такой один.
Цена
Цена за ночь за весь дом плюс доплата за каждого гостя сверх базового числа.
Правила проживания
Минимальный срок, фиксированные дни смены гостей и даты с закрытым заездом — норма.
Сборы и депозиты
Уборка, возвращаемый депозит за ущерб и местные налоги, каждый показан до оплаты.
Заезд
Инструкции по заезду, адрес и контакт отправляются до прибытия, а не на публичной странице.
Типичный источник
Владельцы и управляющие компании, напрямую или через channel-менеджер.

Продаёте дома разных хозяев, а не по своим контрактам? Это маркетплейс, он описан на странице BnB-портал.

Окна отмены

Одна бронь, три окна отмены

Условия отмены — это шкала времени, отсчитываемая назад от даты заезда. Каждое окно определяет, что вернётся гостю, если он отменит бронь внутри него.

БронированиеЗаезд
  1. 01 · До 14 дней до заездаБесплатная отменаГость отменяет и получает полный возврат. Именно этот срок путешественники ищут в первую очередь, поэтому показывайте его датой, а не правилом.
  2. 02 · От 14 до 3 дней до заездаЧастичный штрафПрименяется штраф, часто это первая ночь или процент от стоимости. В аренде в этом окне депозит могут удержать.
  3. 03 · Последние 3 дня и незаездБез возвратаВся сумма удерживается. Тарифы без возврата попадают в это окно с момента бронирования.
Примеры окон; у каждого тарифа свои.
  • На тариф, а не на объектВ одних и тех же апартаментах могут быть гибкий тариф и более дешёвый невозвратный, поэтому условия относятся к уровню тарифа.
  • Даты в часовом поясе объекта«За 14 дней» отсчитывается от даты заезда по времени места, где находится объект. Переведите это в чёткую дату и время на странице и в ваучере.
  • Приоритет у условий поставщикаС API-фондом нельзя предлагать условия мягче, чем даёт поставщик. С собственными контрактами окна вы задаёте сами.

Свой фонд и API-фонд

Ваши объекты по контрактам и API поставщиков в одном поиске

Большинство продавцов жилья делают и то и другое: загружают объекты, с которыми заключили договоры сами, а остальное добирают через API поставщиков. Путешественник не должен замечать, откуда пришло жильё.

Ваши объекты

  • Загружайте объекты, юниты и тарифы сами в админ-панели
  • Дайте владельцам и отелям вход в экстранет для управления календарём
  • Задавайте цены, минимальный срок, закрытые даты и окна отмены
  • Аллотменты со сроками снятия и стоп-сейлом
  • Либо получайте тарифы и доступность из channel-менеджера

Фонд API-поставщиков

  • Большие каталоги в направлениях, где вам не заключить контракты самим
  • Актуальные цены и доступность в момент поиска
  • Питание, условия и сборы поставщика в каждом тарифе
  • Включается вашим собственным договором и ключами поставщика
  • Бронирование и отмена уходят прямо поставщику

Что получает гость

  • Один список результатов и одна страница объекта на каждое место
  • Один и тот же номер из нескольких источников показывается один раз по вашей цене
  • Ваши наценки по поставщику, направлению или каналу и B2B-тарифы для агентов
  • Один формат ваучера, какой бы источник ни подтвердил бронь

Подключение channel-менеджера описано на странице Интеграция с channel manager. О номерах, которые вы держите по контракту, читайте в разделе Система инвентаря бронирований.

Готово в PHPTRAVELS

Уже подключённые поставщики жилья

Эти поставщики размещения уже подключены к модулю Stays. Вы заключаете договор с поставщиком, вводите свои ключи в админ-панели, тестируете в его песочнице и запускаетесь. Список подтягивается в реальном времени из нашего каталога интеграций.

Нужен поставщик, которого нет в списке, например региональная сеть аренды? Можно добавить любой API размещения с документацией, см. Индивидуальная интеграция API. О типах поставщиков отелей и сопоставлении контента читайте на странице API отелей, а два крупнейших бэдбанка разобраны в руководствах Интеграция API RateHawk и Интеграция Hotelbeds API.

Забронируйте жильё так, как это сделают ваши гости

Найдите, сравните тарифы и забронируйте в живой демо-версии, а затем расскажите, какие объекты и поставщиков вы планируете продавать.

Открыть живое демоОбсудить поставщиков

Создаёте собственное приложение или фид для партнёров? REST API PHPTRAVELS отдаёт все подключённые источники жилья в одном формате и поддерживает вебхуки событий бронирования. Он входит в план Enterprise, см. Цены и документация для разработчиков. Общая картина описана на странице Travel API.

Вопросы и ответы

API размещения: вопросы разработчиков и агентств

Отдел продаж

API размещения — это набор веб-сервисов, с помощью которого сайт бронирования ищет жильё, получает цены и доступность на заданные даты и число гостей, а также создаёт, читает и отменяет бронирования. Он охватывает отели и любое другое жильё: апартаменты, аренду для отдыха, хостелы и гостевые дома.

Основные вызовы те же. API размещения должен ещё учитывать то, что нужно жилью не из отелей: бронирование целого юнита, минимальный срок и дни смены гостей, доплаты за дополнительных гостей, плату за уборку, возвращаемые депозиты и инструкции по заезду, отправляемые до прибытия.

Да. В PHPTRAVELS модуль Stays использует одну модель из объекта, юнита, тарифа и доступности для всех видов жилья, поэтому отели, апартаменты и дома для отдыха появляются в одном поиске, каждый со своими правилами.

Для каждой ночи в календаре можно задать минимальную длительность проживания, обычно привязанную к дате заезда. Если гость ищет меньше ночей, чем требуется, юнит не возвращается. Флаги закрытого заезда и закрытого выезда работают так же для дней смены гостей.

Да. Вы можете сами добавлять объекты, юниты, тарифы и календари, давать владельцам вход в экстранет или получать тарифы из channel-менеджера и продавать всё это рядом с фондом поставщиков в одном списке результатов.

Из тарифа. У фонда поставщиков условия поставщика, у ваших объектов — окна, которые задали вы. Крайний срок показывается гостю до оплаты и печатается в ваучере.

Нет. Вы заключаете договор с каждым поставщиком жилья и вводите свои ключи в админ-панели. PHPTRAVELS предоставляет платформу бронирования, модуль Stays и готовые коннекторы.

Да. В плане Enterprise REST API PHPTRAVELS открывает поиск и бронирование по всем подключённым источникам в одном формате, с вебхуками событий бронирования и полным исходным кодом для расширения.

Лицензия PHPTRAVELS, ваш домен и хотя бы один источник фонда: объекты, с которыми вы заключили договоры сами, channel-менеджер или договор с оптовиком по размещению. Весь процесс сначала можно посмотреть в живом демо.

Узнайте больше

Ещё о платформе