Brzi početak

1. Nabavite sandbox pristupne podatke

Registrirajte se na stranici Putnički API-ji. Čim se vaša e-pošta potvrdi, vaš partnerski račun postoji, a na zaslonu se prikazuje ID sandbox ključa; tajni ključ dostavlja se jednokratnom poveznicom za prikaz poslanom na istu adresu. Pohranite ga u upravitelj tajni — prikazuje se točno jednom.

Dobivate i privremenu lozinku za portal za programere, gdje možete izrađivati i rotirati ključeve, postaviti popis dopuštenih IP adresa, pratiti korištenje i zatražiti produkciju.

2. Potpišite svaki zahtjev

Svaki poziv nosi četiri zaglavlja: X-API-Key (ID vašeg ključa), X-Timestamp (unix sekunde), X-Nonce (16–128 nasumičnih znakova) i X-Signature — HMAC-SHA256 kanonskog niza u heksadecimalnom zapisu malim slovima, s vašim tajnim ključem kao ključem.

Kanonski niz čini pet redaka spojenih znakom za novi redak: HTTP metoda velikim slovima, putanja zajedno s query stringom točno kako je poslana, vremenska oznaka, nonce i SHA-256 sirovog tijela u heksadecimalnom zapisu malim slovima (prazno tijelo hashira se kao SHA-256 od nula bajtova). Vremenske oznake moraju biti unutar 300 sekundi od našeg sata; nonce se može upotrijebiti jednom unutar 10 minuta.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Uputite prvi poziv

Pretražite let u sandbox okruženju. Sandbox je povezan s testnim okruženjima naših dobavljača, pa pretraživanja vraćaju testnu ponudu i cijene, a rezervacija napravljena ondje testna je rezervacija — bez stvarne karte i bez naplate. Svaka referentna stranica ima cjelovit primjer u cURL, Node.js, Python i PHP — kopirajte ga, unesite ID ključa i tajni ključ i pokrenite ga.

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. Dovršite tijek rezervacije

Letovi: pretraživanje → izračun cijene odabrane ponude → izrada narudžbe s putnicima i kontaktom → izdavanje karte → (po želji) izračun i zahtjev za povrat novca. Hoteli: pretraživanje → pregled soba smještajnog objekta → provjera cijene → izrada rezervacije → (po želji) izračun i otkazivanje.

ID-jevi ponuda i ključevi cijena neprozirni su i kratkog vijeka. Uvijek izračunajte ili provjerite cijenu neposredno prije potvrde: ako se cijena promijenila, dobit ćete 409 price_changed s novim iznosom, a odluka je vaša.

5. Zatražite produkciju

Kada vaša integracija dovrši tijek od početka do kraja u sandboxu, otvorite portal za programere i zatražite produkciju. Pregledavamo aktivnost u sandboxu (pretraživanja, narudžbu, rezervaciju, otkazivanje) i podatke o vašoj integraciji, a zatim prebacujemo vaš račun: produkcijski par ključeva šalje se e-poštom putem iste jednokratne poveznice za prikaz. Isti osnovni URL — zahtjevi potpisani ključem dt_live_ dosežu stvarne dobavljače i podmiruju se iz vašeg depozita; vaš sandbox ključ i dalje radi za testiranje.