Gyorsútmutató

1. Tesztkörnyezeti hitelesítő adatok igénylése

Regisztráljon az Utazási API-k oldalon. Amint e-mail-címe megerősítést nyer, létrejön a partnerfiókja, és a képernyőn megjelenik a tesztkörnyezeti kulcsazonosító; a titkos kulcsot egy ugyanarra a címre küldött, egyszer használható megjelenítő link tartalmazza. Tárolja titokkezelőjében — pontosan egyszer jelenik meg.

Ideiglenes jelszót is kap a fejlesztői portálhoz, ahol kulcsokat hozhat létre és rotálhat, IP-engedélyezési listát állíthat be, figyelheti a használatot és éles hozzáférést kérhet.

2. Minden kérés aláírása

Minden hívás négy fejlécet tartalmaz: X-API-Key (a kulcsazonosító), X-Timestamp (unix másodpercek), X-Nonce (16–128 véletlen karakter) és X-Signature — egy kanonikus karakterlánc kisbetűs hexadecimális HMAC-SHA256 értéke, a titkos kulccsal mint kulccsal.

A kanonikus karakterlánc öt, sortöréssel összefűzött sor: a HTTP-metódus nagybetűvel, az útvonal a lekérdezési karakterlánccal pontosan úgy, ahogy elküldték, az időbélyeg, a nonce, valamint a nyers törzs kisbetűs hexadecimális SHA-256 értéke (üres törzs esetén a nulla bájt SHA-256 értéke). Az időbélyeg legfeljebb 300 másodperccel térhet el az óránktól; egy nonce 10 percen belül csak egyszer használható.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Az első hívás

Keressen járatot a tesztkörnyezetben (sandbox). A sandbox beszállítóink tesztkörnyezeteihez kapcsolódik, így a keresések tesztkínálatot és tesztárakat adnak vissza, az ott leadott foglalás pedig tesztfoglalás — nincs valódi jegy és nincs terhelés. Minden referenciaoldalon teljes minta található cURL, Node.js, Python és PHP nyelven — másolja ki, adja meg a kulcsazonosítóját és a titkos kulcsát, majd futtassa.

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. Egy foglalási folyamat végigvitele

Repülőjegyek: keresés → a kiválasztott ajánlat árazása → rendelés létrehozása utasokkal és kapcsolattartóval → jegykiállítás → (opcionálisan) árajánlat és visszatérítés kérése. Szállások: keresés → egy szálláshely szobáinak lekérése → árellenőrzés → foglalás létrehozása → (opcionálisan) árajánlat és lemondás.

Az ajánlatazonosítók és árkulcsok átlátszatlanok és rövid életűek. Mindig közvetlenül a véglegesítés előtt árazzon vagy ellenőrizzen: ha az ár megváltozott, 409 price_changed választ kap az új összeggel, és Ön dönt.

5. Éles hozzáférés kérése

Amikor az integrációja a tesztkörnyezetben elejétől a végéig végigviszi a folyamatot, nyissa meg a fejlesztői portált, és kérjen éles hozzáférést. Átnézzük a tesztkörnyezeti tevékenységet (keresések, egy rendelés, egy foglalás, egy lemondás) és az integráció részleteit, majd átállítjuk a fiókját: az éles kulcspárt ugyanazon az egyszer használható megjelenítő linken keresztül küldjük el e-mailben. Az alap URL ugyanaz — a dt_live_ kulccsal aláírt kérések az élő beszállítókat érik el, és a letétjéből kerülnek elszámolásra; a tesztkörnyezeti kulcsa továbbra is működik teszteléshez.