Brzi početak

1. Preuzmite sandbox akreditive

Registrujte se na stranici Putnički API-ji. Kada se vaš imejl potvrdi, vaš partnerski nalog postoji i na ekranu se prikazuje ID sandbox ključa; tajni ključ se dostavlja jednokratnim linkom za prikaz koji se šalje na istu adresu. Sačuvajte ga u svom menadžeru tajni — prikazuje se tačno jednom.

Dobijate i privremenu lozinku za portal za programere, gde možete da pravite i menjate ključeve, podesite listu dozvoljenih IP adresa, pratite korišćenje i zatražite produkciju.

2. Potpišite svaki zahtev

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 stringa u heksadecimalnom zapisu malim slovima, izračunat vašim tajnim ključem.

Kanonski string čini pet redova spojenih znakom za novi red: HTTP metod velikim slovima, putanja zajedno sa stringom upita tačno onako kako je poslata, vremenska oznaka, nonce i SHA-256 sirovog tela u heksadecimalnom zapisu malim slovima (prazno telo se hešira kao SHA-256 od nula bajtova). Vremenske oznake moraju biti u okviru 300 sekundi od našeg sata; nonce se može upotrebiti jednom u roku od 10 minuta.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Uputite prvi poziv

Pretražite let u sandbox okruženju. Sandbox je povezan sa test okruženjima naših dobavljača, pa pretrage vraćaju test inventar i cene, a rezervacija napravljena tamo je test rezervacija — bez prave karte i bez naplate. Svaka referentna stranica ima kompletan primer 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. Završite tok rezervacije

Letovi: pretraga → obračun cene izabrane ponude → kreiranje porudžbine sa putnicima i kontaktom → izdavanje karte → (opciono) ponuda za povraćaj i zahtev za povraćaj. Hoteli: pretraga → čitanje soba objekta → provera cene → kreiranje rezervacije → (opciono) ponuda za otkazivanje i otkazivanje.

ID-jevi ponuda i ključevi cena su neprozirni i kratkotrajni. Uvek obračunajte ili proverite cenu neposredno pre obavezivanja: ako se cena promenila, dobićete 409 price_changed sa novim iznosom, a odluka je na vama.

5. Zatražite produkciju

Kada vaša integracija u sandbox okruženju prođe ceo tok od početka do kraja, otvorite portal za programere i zatražite produkciju. Pregledamo aktivnost u sandbox okruženju (pretrage, porudžbinu, rezervaciju, otkazivanje) i detalje integracije, a zatim prebacujemo vaš nalog: par produkcionih ključeva šalje se imejlom preko istog jednokratnog linka za prikaz. Osnovni URL je isti — zahtevi potpisani dt_live_ ključem stižu do stvarnih dobavljača i naplaćuju se iz vašeg depozita; vaš sandbox ključ i dalje radi za testiranje.