Бърз старт

1. Вземете идентификационни данни за sandbox

Регистрирайте се на страницата Туристически API. След като имейлът ви бъде потвърден, партньорският ви акаунт е създаден и на екрана се показва ID на ключа за sandbox; тайният ключ се доставя чрез еднократен линк за показване, изпратен на същия адрес. Съхранявайте го в мениджъра си за тайни — показва се точно веднъж.

Получавате и временна парола за портала за разработчици, където можете да създавате и сменяте ключове, да задавате списък с разрешени IP адреси, да следите използването и да заявите production.

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. Заявете production

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