Περιβάλλοντα, όρια και εκδόσεις
Ένα βασικό URL για sandbox και παραγωγή· το κλειδί με το οποίο υπογράφετε επιλέγει το περιβάλλον.
Sandbox και παραγωγή, ένα βασικό URL
Βασικό URL: https://api.dubaitrip.com/v1. Το sandbox και η παραγωγή το μοιράζονται· το κλειδί με το οποίο υπογράφετε επιλέγει το περιβάλλον. Ένα κλειδί dt_sbx_ λειτουργεί έναντι των περιβαλλόντων δοκιμών των προμηθευτών μας — αναζητήσεις, τιμολόγηση, έλεγχοι τιμών, παραγγελίες, κρατήσεις, έκδοση εισιτηρίων και ακυρώσεις λειτουργούν όλα από άκρη σε άκρη σε δοκιμαστικό απόθεμα, χωρίς πραγματικό εισιτήριο ή voucher και χωρίς καμία χρέωση. Ένα κλειδί dt_live_, που εκδίδεται μετά την αξιολόγηση για παραγωγή, φτάνει στο ζωντανό απόθεμα και εκκαθαρίζεται από την εγγύησή σας.
Οι κρατήσεις sandbox και παραγωγής διατηρούνται χωριστά στην πύλη προγραμματιστών σας (κάθε κράτηση επισημαίνεται), ενώ τα δικαιώματα, τα όρια και οι κανόνες IP διαχειρίζονται ανά περιβάλλον.
Όρια ρυθμού και ποσοστώσεις
Κάθε κλειδί περιορίζεται από ένα token bucket (σταθερά αιτήματα ανά δευτερόλεπτο συν μια ριπή) και από μια ημερήσια ποσόστωση. Προεπιλογές sandbox: 2 αιτήματα/δευτερόλεπτο, ριπή 5, 2.000 αιτήματα/ημέρα. Τα όρια παραγωγής συμφωνούνται ανά λογαριασμό. Η υπέρβαση του bucket απαντά 429 api_rate_limited με κεφαλίδα Retry-After· η εξάντληση της ποσόστωσης απαντά 429 api_quota_exceeded έως τα μεσάνυχτα UTC.
Οι βαριές αναζητήσεις είναι εκ σχεδιασμού ασύγχρονες: περάστε wait=false για να λάβετε αμέσως ένα searchId και να κάνετε polling στο endpoint αναζήτησης, ή wait=true για να λάβετε το πλήρες αποτέλεσμα σε μία κλήση. Το polling μετράει στα όριά σας όπως κάθε άλλο αίτημα.
Όριο look-to-book
Οι αναζητήσεις κατανέμονται επίσης με βάση τις κρατήσεις που κάνετε. Κάθε ημέρα ενός κυλιόμενου παραθύρου (7 ημέρες από προεπιλογή) δίνει ένα δωρεάν όριο αναζητήσεων, και κάθε κράτηση μέσα σε αυτό το παράθυρο προσθέτει άλλες cap αναζητήσεις — το cap είναι ο αριθμός αναζητήσεων ανά κράτηση που έχει συμφωνηθεί για τον λογαριασμό σας και εμφανίζεται στην πύλη προγραμματιστών. Το polling, η τιμολόγηση, οι κανόνες ναύλου και οι αναγνώσεις περιεχομένου δεν μετρούν ποτέ· μετρούν μόνο οι κλήσεις αναζήτησης πτήσεων και ξενοδοχείων.
Μόλις εξαντληθεί το όριο, οι αναζητήσεις απαντούν 429 look_to_book_exceeded με κεφαλίδα Retry-After που δείχνει τα επόμενα μεσάνυχτα UTC, όταν η παλαιότερη ημέρα του παραθύρου αποχωρεί. Μια κράτηση ανοίγει ξανά το όριο αμέσως. Η κάρτα Look-to-book στην πύλη προγραμματιστών δείχνει τους ζωντανούς μετρητές, το cap και ό,τι απομένει· αν η ενσωμάτωσή σας εύλογα κάνει πολύ περισσότερες αναζητήσεις από κρατήσεις, ζητήστε μας να αυξήσουμε το cap αντί να επαναλαμβάνετε τα αιτήματα παρά την άρνηση.
Idempotency
Τα endpoints που δεσμεύουν χρήματα ή απόθεμα — δημιουργία παραγγελίας ή κράτησης, έκδοση, ακύρωση — απαιτούν κεφαλίδα Idempotency-Key (οποιαδήποτε μοναδική συμβολοσειρά έως 128 χαρακτήρες· ένα UUID είναι ιδανικό). Η επανάληψη με το ίδιο κλειδί επιστρέφει την αρχική απόκριση αντί να δημιουργήσει διπλότυπο· διαφορετικό σώμα με επαναχρησιμοποιημένο κλειδί απαντά 409.
Εκδόσεις
Η έκδοση βρίσκεται στη διαδρομή (/v1). Οι προσθετικές αλλαγές — νέα προαιρετικά πεδία, νέες τιμές enum, νέα endpoints — κυκλοφορούν χωρίς αλλαγή έκδοσης, οπότε κάντε αμυντική ανάλυση και αγνοήστε τα άγνωστα πεδία. Οι αλλαγές που σπάνε τη συμβατότητα αποκτούν νέα κύρια έκδοση με παράθυρο μετάβασης· ο οδηγός Αρχείο αλλαγών καταγράφει κάθε αλλαγή.