Швидкий старт

1. Отримайте облікові дані пісочниці

Зареєструйтеся на сторінці Тревел-API. Щойно вашу пошту буде підтверджено, партнерський обліковий запис створюється, а ID ключа пісочниці з’являється на екрані; секрет надходить через одноразове посилання для розкриття на ту саму адресу. Збережіть його в менеджері секретів — він показується рівно один раз.

Ви також отримуєте тимчасовий пароль до порталу розробника, де можна створювати й ротувати ключі, задавати список дозволених 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. Зробіть перший виклик

Виконайте пошук рейсу в пісочниці. Пісочниця підключена до тестових середовищ наших постачальників, тож пошук повертає тестовий інвентар і ціни, а бронювання, створене там, є тестовим — без справжнього квитка й без списання коштів. На кожній довідковій сторінці є повний приклад на 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. Запросіть продакшн

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