Γρήγορη εκκίνηση

1. Λάβετε διαπιστευτήρια sandbox

Εγγραφείτε στη σελίδα Ταξιδιωτικά API. Μόλις επαληθευτεί το email σας, ο λογαριασμός συνεργάτη σας δημιουργείται και εμφανίζεται στην οθόνη ένα αναγνωριστικό κλειδιού sandbox· το μυστικό παραδίδεται μέσω συνδέσμου εμφάνισης μίας χρήσης που αποστέλλεται στην ίδια διεύθυνση. Αποθηκεύστε το στον διαχειριστή μυστικών σας — εμφανίζεται ακριβώς μία φορά.

Λαμβάνετε επίσης έναν προσωρινό κωδικό πρόσβασης για την πύλη προγραμματιστών, όπου μπορείτε να δημιουργείτε και να εναλλάσσετε κλειδιά, να ορίζετε λίστα επιτρεπόμενων IP, να παρακολουθείτε τη χρήση και να ζητάτε παραγωγή.

2. Υπογράψτε κάθε αίτημα

Κάθε κλήση φέρει τέσσερις κεφαλίδες: X-API-Key (το αναγνωριστικό του κλειδιού σας), X-Timestamp (δευτερόλεπτα unix), X-Nonce (16–128 τυχαίοι χαρακτήρες) και X-Signature — το HMAC-SHA256 σε πεζά δεκαεξαδικά μιας κανονικοποιημένης συμβολοσειράς, με κλειδί το μυστικό σας.

Η κανονικοποιημένη συμβολοσειρά αποτελείται από πέντε γραμμές ενωμένες με χαρακτήρα νέας γραμμής: η μέθοδος HTTP με κεφαλαία, η διαδρομή μαζί με το query string ακριβώς όπως αποστέλλεται, το timestamp, το nonce και το SHA-256 σε πεζά δεκαεξαδικά του ακατέργαστου σώματος (ένα κενό σώμα κατακερματίζεται ως το SHA-256 μηδέν byte). Τα timestamps πρέπει να απέχουν έως 300 δευτερόλεπτα από το ρολόι μας· ένα nonce μπορεί να χρησιμοποιηθεί μία φορά μέσα σε 10 λεπτά.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Κάντε την πρώτη σας κλήση

Αναζητήστε μια πτήση στο sandbox. Το sandbox είναι συνδεδεμένο με τα περιβάλλοντα δοκιμών των προμηθευτών μας, οπότε οι αναζητήσεις επιστρέφουν δοκιμαστικό απόθεμα και τιμές, και μια κράτηση που γίνεται εκεί είναι δοκιμαστική — χωρίς πραγματικό εισιτήριο, χωρίς χρέωση. Κάθε σελίδα αναφοράς έχει πλήρες παράδειγμα σε cURL, Node.js, Python και PHP — αντιγράψτε το, συμπληρώστε το αναγνωριστικό κλειδιού και το μυστικό σας και εκτελέστε το.

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. Ολοκληρώστε μια ροή κράτησης

Πτήσεις: αναζήτηση → τιμολόγηση της επιλεγμένης προσφοράς → δημιουργία παραγγελίας με επιβάτες και στοιχεία επικοινωνίας → έκδοση εισιτηρίου → (προαιρετικά) προσφορά και αίτημα επιστροφής χρημάτων. Ξενοδοχεία: αναζήτηση → ανάγνωση των δωματίων ενός καταλύματος → έλεγχος τιμής → δημιουργία κράτησης → (προαιρετικά) προσφορά και ακύρωση.

Τα αναγνωριστικά προσφορών και τα κλειδιά τιμών είναι αδιαφανή και βραχύβια. Πάντα τιμολογείτε ή ελέγχετε ακριβώς πριν δεσμευτείτε: αν η τιμή άλλαξε λαμβάνετε 409 price_changed με το νέο ποσό, και αποφασίζετε εσείς.

5. Ζητήστε παραγωγή

Όταν η ενσωμάτωσή σας ολοκληρώνει τη ροή από άκρη σε άκρη στο sandbox, ανοίξτε την πύλη προγραμματιστών και ζητήστε παραγωγή. Εξετάζουμε τη δραστηριότητα στο sandbox (αναζητήσεις, μια παραγγελία, μια κράτηση, μια ακύρωση) και τα στοιχεία της ενσωμάτωσής σας και μετά μεταφέρουμε τον λογαριασμό σας: ένα ζεύγος κλειδιών παραγωγής αποστέλλεται με email μέσω του ίδιου συνδέσμου εμφάνισης μίας χρήσης. Ίδιο βασικό URL — τα αιτήματα που υπογράφονται με το κλειδί dt_live_ φτάνουν στους ζωντανούς προμηθευτές και εκκαθαρίζονται από την εγγύησή σας· το κλειδί sandbox συνεχίζει να λειτουργεί για δοκιμές.