Быстрый старт

1. Получите учётные данные sandbox

Зарегистрируйтесь на странице Тревел-API. После подтверждения почты ваш партнёрский аккаунт создаётся, а ID ключа sandbox отображается на экране; секрет приходит по одноразовой ссылке раскрытия на тот же адрес. Сохраните его в менеджере секретов — он показывается ровно один раз.

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

2. Подписывайте каждый запрос

Каждый вызов содержит четыре заголовка: X-API-Key (ID вашего ключа), X-Timestamp (секунды unix), X-Nonce (16–128 случайных символов) и X-Signature — HMAC-SHA256 канонической строки в нижнем регистре hex, вычисленный с вашим секретом в качестве ключа.

Каноническая строка — это пять строк, соединённых символом перевода строки: HTTP-метод в верхнем регистре, путь со строкой запроса ровно в том виде, в каком они отправлены, метка времени, nonce и SHA-256 сырого тела в нижнем регистре hex (для пустого тела берётся SHA-256 от нуля байт). Метка времени должна отличаться от наших часов не более чем на 300 секунд; nonce можно использовать один раз в течение 10 минут.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Сделайте первый вызов

Выполните поиск рейса в sandbox. Sandbox подключён к тестовым средам наших поставщиков, поэтому поиск возвращает тестовый инвентарь и цены, а бронирование, созданное там, — тестовое: без настоящего билета и без списания средств. На каждой справочной странице есть полный пример на cURL, Node.js, Python и PHP — скопируйте его, подставьте ID ключа и секрет и запустите.

curl -X POST "https://api.dubaitrip.com/v1/flights/search" \
  -H "X-API-Key: $KEY_ID" -H "X-Timestamp: $TS" -H "X-Nonce: $NONCE" -H "X-Signature: $SIG" \
  -H "Content-Type: application/json" \
  -d '{"slices":[{"origin":"DXB","destination":"LHR","departureDate":"2026-11-15"}],"passengers":{"adults":1},"wait":true}'

4. Пройдите процесс бронирования

Авиабилеты: поиск → расчёт цены выбранного предложения → создание заказа с пассажирами и контактом → выписка билета → (при необходимости) расчёт и запрос возврата. Отели: поиск → получение номеров объекта → проверка тарифа → создание бронирования → (при необходимости) расчёт и отмена.

ID предложений и ключи тарифов непрозрачны и живут недолго. Всегда пересчитывайте цену или проверяйте тариф непосредственно перед подтверждением: если цена изменилась, вы получите 409 price_changed с новой суммой, и решение за вами.

5. Запросите продакшен

Когда ваша интеграция проходит весь процесс от начала до конца в sandbox, откройте портал разработчика и запросите продакшен. Мы проверим активность в sandbox (поиски, заказ, бронирование, отмену) и данные интеграции, затем переключим ваш аккаунт: пара ключей для продакшена придёт через такую же одноразовую ссылку раскрытия. Базовый URL тот же — запросы, подписанные ключом dt_live_, идут к реальным поставщикам и оплачиваются с вашего депозита; ключ sandbox продолжает работать для тестирования.