Hopp til innholdet

Hurtigstart

Fra registrering til en bestilt flyreise i sandkassen, i fem trinn.

  1. 1. Få sandkassenøkler
  2. 2. Signer hver forespørsel
  3. 3. Gjør ditt første kall
  4. 4. Fullfør en bestillingsflyt
  5. 5. Be om produksjon

1. Få sandkassenøkler

Registrer deg på siden for reise-API-er. Så snart e-postadressen din er bekreftet, er partnerkontoen din opprettet og en sandkassenøkkel-ID vises på skjermen; hemmeligheten leveres via en engangslenke sendt til samme adresse. Lagre den i hemmelighetsbehandleren din – den vises nøyaktig én gang.

Du får også et midlertidig passord til utviklerportalen, der du kan opprette og rotere nøkler, angi en IP-tillatelsesliste, følge med på bruken og be om produksjon.

2. Signer hver forespørsel

Hvert kall har fire headere: X-API-Key (nøkkel-ID-en din), X-Timestamp (Unix-sekunder), X-Nonce (16–128 tilfeldige tegn) og X-Signature – HMAC-SHA256 i heksadesimal med små bokstaver av en kanonisk streng, med hemmeligheten din som nøkkel.

Den kanoniske strengen består av fem linjer skilt med linjeskift: HTTP-metoden med store bokstaver, stien pluss spørrestrengen nøyaktig slik den sendes, tidsstempelet, nonce-verdien og SHA-256 i heksadesimal med små bokstaver av den rå forespørselsteksten (en tom tekst gir SHA-256 av null byte). Tidsstempler må ligge innenfor 300 sekunder av klokken vår; en nonce kan brukes én gang innenfor 10 minutter.

Kanonisk streng
POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Gjør ditt første kall

Søk etter en flyreise mot sandkassen. Sandkassen er koblet til leverandørenes testmiljøer, så søk returnerer testutvalg og testpriser, og en bestilling som gjøres der, er en testbestilling — ingen ekte billett, ingen belastning. Hver referanseside har et komplett eksempel i cURL, Node.js, Python og PHP — kopier det, fyll inn nøkkel-ID-en og hemmeligheten din, og kjør det.

cURL
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. Fullfør en bestillingsflyt

Fly: søk → pris det valgte tilbudet → opprett ordren med passasjerer og kontaktperson → utsted billetten → (valgfritt) hent refusjonstilbud og be om refusjon. Hotell: søk → les rommene for et overnattingssted → kontroller prisen → opprett bestillingen → (valgfritt) hent tilbud og kanseller.

Tilbuds-ID-er og prisnøkler er ugjennomsiktige og kortlevde. Pris eller kontroller alltid rett før du forplikter deg: hvis prisen har endret seg, får du 409 price_changed med det nye beløpet, og du bestemmer.

5. Be om produksjon

Når integrasjonen din fullfører flyten fra start til slutt i sandkassen, åpner du utviklerportalen og ber om produksjon. Vi går gjennom sandkasseaktiviteten (søk, en ordre, en bestilling, en kansellering) og integrasjonsdetaljene dine, og bytter deretter kontoen din: et produksjonsnøkkelpar sendes på e-post via den samme engangslenken. Samme basis-URL – forespørsler signert med dt_live_-nøkkelen når de faktiske leverandørene og gjøres opp mot depositumet ditt; sandkassenøkkelen din fortsetter å virke for testing.