Szybki start

1. Uzyskaj dane dostępowe do sandboksa

Zarejestruj się na stronie API turystycznych. Po weryfikacji e-maila Twoje konto partnera jest gotowe, a ID klucza do sandboksa pojawia się na ekranie; sekret jest dostarczany jednorazowym linkiem do ujawnienia wysłanym na ten sam adres. Przechowuj go w menedżerze sekretów — jest wyświetlany dokładnie raz.

Otrzymasz też tymczasowe hasło do portalu dewelopera, w którym możesz tworzyć i rotować klucze, ustawić listę dozwolonych IP, śledzić użycie i złożyć wniosek o produkcję.

2. Podpisuj każde żądanie

Każde wywołanie zawiera cztery nagłówki: X-API-Key (ID Twojego klucza), X-Timestamp (sekundy unix), X-Nonce (16–128 losowych znaków) i X-Signature — HMAC-SHA256 ciągu kanonicznego zapisany małymi literami w hex, z Twoim sekretem jako kluczem.

Ciąg kanoniczny to pięć wierszy połączonych znakiem nowej linii: metoda HTTP wielkimi literami, ścieżka wraz z query stringiem dokładnie w wysłanej postaci, znacznik czasu, nonce oraz SHA-256 surowej treści zapisany małymi literami w hex (pusta treść daje SHA-256 z zera bajtów). Znacznik czasu musi mieścić się w 300 sekundach od naszego zegara; nonce można użyć raz w ciągu 10 minut.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Wykonaj pierwsze wywołanie

Wyszukaj lot w sandboksie. Sandbox jest połączony ze środowiskami testowymi naszych dostawców, więc wyszukiwania zwracają testową ofertę i ceny, a rezerwacja złożona w sandboksie jest rezerwacją testową — bez prawdziwego biletu i bez obciążenia. Każda strona referencyjna zawiera kompletny przykład w cURL, Node.js, Python i PHP — skopiuj go, wpisz ID klucza i sekret, uruchom.

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. Przejdź cały proces rezerwacji

Loty: wyszukiwanie → wycena wybranej oferty → utworzenie zamówienia z pasażerami i kontaktem → wystawienie biletu → (opcjonalnie) wycena i wniosek o zwrot. Hotele: wyszukiwanie → odczyt pokoi obiektu → weryfikacja stawki → utworzenie rezerwacji → (opcjonalnie) wycena anulowania i anulowanie.

ID ofert i klucze stawek są nieprzezroczyste i krótkotrwałe. Zawsze wyceniaj lub weryfikuj tuż przed zatwierdzeniem: jeśli cena się zmieniła, otrzymasz 409 price_changed z nową kwotą, a decyzja należy do Ciebie.

5. Złóż wniosek o produkcję

Gdy Twoja integracja przechodzi cały proces od początku do końca w sandboksie, otwórz portal dewelopera i złóż wniosek o produkcję. Sprawdzamy aktywność w sandboksie (wyszukiwania, zamówienie, rezerwację, anulowanie) i szczegóły integracji, a potem przełączamy Twoje konto: produkcyjna para kluczy trafia do Ciebie e-mailem przez taki sam jednorazowy link do ujawnienia. Base URL pozostaje ten sam — żądania podpisane kluczem dt_live_ trafiają do rzeczywistych dostawców i są rozliczane z Twojego depozytu; klucz do sandboksa nadal działa do testów.