Pikaopas

1. Hanki sandbox-tunnukset

Rekisteröidy Matkailurajapinnat-sivulla. Kun sähköpostisi on vahvistettu, kumppanitilisi on olemassa ja sandboxin avaintunniste näytetään näytöllä; salainen avain toimitetaan kertakäyttöisellä näyttölinkillä samaan osoitteeseen. Tallenna se salaisuuksien hallintaan – se näytetään tasan kerran.

Saat myös väliaikaisen salasanan kehittäjäportaaliin, jossa voit luoda ja vaihtaa avaimia, määrittää sallittujen IP-osoitteiden listan, seurata käyttöä ja pyytää tuotantoa.

2. Allekirjoita jokainen pyyntö

Jokaisessa kutsussa on neljä otsaketta: X-API-Key (avaintunnisteesi), X-Timestamp (Unix-sekunnit), X-Nonce (16–128 satunnaista merkkiä) ja X-Signature – kanonisen merkkijonon HMAC-SHA256 pienin kirjaimin heksadesimaalina, avaimena salainen avaimesi.

Kanoninen merkkijono on viisi riviä rivinvaihdolla yhdistettynä: HTTP-metodi isoin kirjaimin, polku ja kyselymerkkijono täsmälleen lähetetyssä muodossa, aikaleima, nonce sekä raa'an rungon SHA-256 pienin kirjaimin heksadesimaalina (tyhjän rungon tiiviste on nollan tavun SHA-256). Aikaleiman on oltava 300 sekunnin sisällä kellostamme; noncea voi käyttää vain kerran 10 minuutin aikana.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Tee ensimmäinen kutsusi

Tee lentohaku sandboxia vasten. Sandbox on kytketty toimittajiemme testiympäristöihin, joten haut palauttavat testivarantoa ja -hintoja, ja siellä tehty varaus on testivaraus – ei oikeaa lippua, ei veloitusta. Jokaisella referenssisivulla on täydellinen esimerkki kielillä cURL, Node.js, Python ja PHP – kopioi se, täytä avaintunnisteesi ja salainen avaimesi ja aja se.

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. Vie varauskulku loppuun

Lennot: haku → valitun tarjouksen hinnoittelu → tilauksen luonti matkustajineen ja yhteystietoineen → lipunkirjoitus → (valinnaisesti) hyvitysarvio ja hyvityspyyntö. Hotellit: haku → kohteen huoneiden haku → hinnan tarkistus → varauksen luonti → (valinnaisesti) peruutusarvio ja peruutus.

Tarjoustunnisteet ja hinta-avaimet ovat läpinäkymättömiä ja lyhytikäisiä. Hinnoittele tai tarkista aina juuri ennen sitoutumista: jos hinta on muuttunut, saat 409 price_changed uuden summan kera, ja päätös on sinun.

5. Pyydä tuotantoa

Kun integraatiosi vie kulun alusta loppuun sandboxissa, avaa kehittäjäportaali ja pyydä tuotantoa. Tarkistamme sandbox-toiminnan (haut, tilauksen, varauksen, peruutuksen) ja integraatiosi tiedot ja siirrämme sitten tilisi: tuotannon avainpari lähetetään sähköpostitse samalla kertakäyttöisellä näyttölinkillä. Perus-URL pysyy samana – dt_live_-avaimella allekirjoitetut pyynnöt ohjautuvat todellisille toimittajille ja veloitetaan talletuksestasi; sandbox-avaimesi toimii edelleen testaukseen.