Документация

Техническая документация

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

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

Обзор

Connect API - это интерфейс JSON поверх HTTPS, открывающий автоматизируемую часть нашего стамбульского инвентаря: поиск доступности, формирование нетто-цен и бронирование с мгновенным подтверждением. Партнёры на основе фида получают те же данные о продуктах в виде структурированного XML-фида инвентаря.

Аутентификация

Запросы аутентифицируются с помощью отдельного для каждого партнёра ключа API, передаваемого в заголовке Authorization поверх TLS. Ключи выдаются для каждой среды (песочница и продакшен) при подключении.

# Заголовок Authorization
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx
Accept: application/json

Доступность

Запрашивайте актуальную доступность и нетто-тарифы для продукта и диапазона дат перед продажей. В ответе возвращаются доступные для бронирования варианты с ценами и правилами.

GET /v1/availability?product=hagia-sophia-grand-bazaar&date=2026-06-14

200 OK
{
  "product": "hagia-sophia-grand-bazaar",
  "currency": "EUR",
  "available": true,
  "options": [
    { "time": "09:00", "net": 149.50, "confirmation": "instant" }
  ]
}

Бронирование

Создавайте бронирование по доступному варианту. Успешный ответ сразу возвращает код подтверждения и данные ваучера для стандартного инвентаря.

POST /v1/bookings
{
  "product": "hagia-sophia-grand-bazaar",
  "date": "2026-06-14",
  "time": "09:00",
  "pax": { "adults": 2, "children": 1 },
  "lead": { "name": "...", "email": "..." }
}

201 Created
{ "reference": "MKN-8F3A21", "status": "confirmed" }

Фиды инвентаря

Партнёры, предпочитающие синхронизацию каталога, получают XML-фид продуктов, описаний, тарифов и правил, забираемый по расписанию или по запросу. Фид чисто сопоставляется с большинством каталогов агентств и OTA.

GET /feed/inventory.xml

<product code="hagia-sophia-grand-bazaar" type="tour">
  <title>Hagia Sophia & Grand Bazaar Tour</title>
  <duration>PT8H</duration>
  <net currency="EUR">149.50</net>
  <pickup>hotel</pickup>
</product>

Нужен полный справочник?

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

Запросить документацию API