Μετάβαση στο περιεχόμενο
Ιστολόγιο

Διαχείριση σφαλμάτων API κρατήσεων: τρεις αστοχίες που κοστίζουν

Σύνταξη Tekravel
Γράφτηκε με τη βοήθεια τεχνητής νοημοσύνης

Το αίτημα υποστήριξης φτάνει ένα βράδυ Πέμπτης. Ένας πελάτης πλήρωσε, η σελίδα γύριζε και μετά έδειξε ένα γενικό σφάλμα. Η κάρτα χρεώθηκε. Τα logs σας δείχνουν ένα POST προς τον προμηθευτή που δεν πήρε ποτέ απάντηση. Κράτησε η αεροπορική εταιρεία θέση; Κανείς δεν μπορεί να σας πει, και ο πελάτης περιμένει. Η σωστή διαχείριση σφαλμάτων API κρατήσεων είναι κυρίως η δουλειά του να μη βρεθείτε ποτέ σε αυτή τη θέση ή, τουλάχιστον, να ξέρετε ακριβώς τι να κάνετε όταν βρεθείτε.

Οι περισσότεροι οδηγοί ενσωμάτωσης αντιμετωπίζουν τα σφάλματα ως κατάλογο κωδικών κατάστασης. Στις κρατήσεις οι κωδικοί είναι το εύκολο κομμάτι. Αυτό που κοστίζει είναι ένα μικρό σύνολο καταστάσεων όπου το αίτημα φαίνεται να απέτυχε αλλά ο κόσμος άλλαξε παρ' όλα αυτά, ή φαίνεται να πέτυχε ενώ ο κόσμος δεν άλλαξε. Τρεις από αυτές μετρούν περισσότερο από τις υπόλοιπες.

Αστοχία πρώτη: η τιμή άλλαξε ανάμεσα στην αναζήτηση και την κράτηση

Τα αποτελέσματα αναζήτησης είναι προσφορά, όχι συμβόλαιο. Οι ναύλοι αποθηκεύονται προσωρινά, το απόθεμα μοιράζεται σε κάθε κανάλι μέσω του οποίου πουλά ο προμηθευτής, και ο αριθμός που δείξατε στις 14:02 μπορεί να είναι ξεπερασμένος λίγα λεπτά αργότερα. Ο προμηθευτής σάς το λέει στο βήμα δημιουργίας κράτησης, άλλοτε με καθαρή απάντηση «ο ναύλος άλλαξε», άλλοτε επιστρέφοντας αθόρυβα διαφορετικό σύνολο μέσα σε μια κατά τα άλλα επιτυχή απάντηση.

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

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

Αστοχία δεύτερη: κρατήθηκε, αλλά δεν εκδόθηκε

Η ύπαρξη ενός PNR δεν σημαίνει ότι υπάρχει εισιτήριο. Πολλές ροές δημιουργούν πρώτα την κράτηση και εκδίδουν το ηλεκτρονικό εισιτήριο σε ξεχωριστό βήμα, με χρονικό όριο ανάμεσά τους. Αν η πληρωμή πετύχει και η έκδοση αποτύχει, κρατάτε τα χρήματα ενός πελάτη και μια κράτηση που θα λήξει με το δικό της ρολόι.

Η αστοχία σπάνια είναι θορυβώδης. Η κλήση έκδοσης επιστρέφει σφάλμα ή timeout και η κράτηση μένει σε μια κατάσταση που η βάση σας ονομάζει «πληρωμένη» ενώ ο προμηθευτής λέει ακόμη «σε αναμονή». Στο μεταξύ το χρονικό όριο έκδοσης τρέχει και, αντίθετα με την ουρά υποστήριξής σας, η αεροπορική δεν περιμένει.

Χειριστείτε το ως ξεχωριστή κατάσταση, όχι ως παραλλαγή της επιτυχίας ή της αποτυχίας. Μια κράτηση χρειάζεται τουλάχιστον αυτές: δημιουργήθηκε, σε αναμονή, πληρωμή εισπράχθηκε, σε έκδοση, εκδόθηκε, απέτυχε-και-επιστρέφεται. Η «πληρωμή εισπράχθηκε, σε έκδοση» είναι η κατάσταση που χρειάζεται χρονόμετρο: όταν μια κράτηση μείνει εκεί πολύ, μια εργασία πρέπει να ξαναδιαβάσει την κράτηση από τον προμηθευτή και να αποφασίσει, χωρίς να περιμένει να το προσέξει άνθρωπος. Η απόφαση είναι φθηνή όταν ξέρετε το χρονικό όριο του προμηθευτή, γιατί σας λέει πόση ώρα μπορείτε με ασφάλεια να ξαναδοκιμάζετε πριν πρέπει να επιστρέψετε τα χρήματα.

Αστοχία τρίτη: το timeout με άγνωστο αποτέλεσμα

Αυτό είναι το αίτημα της βραδιάς της Πέμπτης. Το αίτημά σας έφυγε, καμία απάντηση δεν γύρισε, η σύνδεση πέθανε ή η πύλη τα παράτησε. Ο προμηθευτής μπορεί να το επεξεργάστηκε πλήρως, εν μέρει ή καθόλου.

Ο πειρασμός είναι να ξαναδοκιμάσετε. Μην επαναλαμβάνετε στα τυφλά μια κλήση δημιουργίας κράτησης, γιατί η δεύτερη προσπάθεια μπορεί να παράγει δεύτερη κράτηση, και το διπλότυπο έχει πραγματικό κόστος: δύο θέσεις δεσμευμένες, ίσως δύο εισιτήρια, μια διαφωνία επιστροφής χρημάτων.

Η ασφαλής σειρά είναι: σταματήστε, διαβάστε, αποφασίστε. Σταματήστε τη ροή προς τον πελάτη με μια ειλικρινή κατάσταση «επιβεβαιώνουμε την κράτησή σας». Διαβάστε την πλευρά του προμηθευτή αναζητώντας την κράτηση με την αναφορά που δημιουργήσατε πριν από την κλήση (γι' αυτό δημιουργείτε πρώτα τη δική σας αναφορά πελάτη και τη στέλνετε, αν ο προμηθευτής τη δέχεται). Μόνο τότε αποφασίστε: αν βρέθηκε, συνεχίστε από την πραγματική κατάσταση. Αν δεν βρέθηκε μετά το δικό του παράθυρο επεξεργασίας, είναι ασφαλές να ξαναδοκιμάσετε μία φορά.

Αν ο προμηθευτής δεν προσφέρει αναζήτηση με τη δική σας αναφορά, ψάξτε με όνομα επιβάτη, διαδρομή και ημερομηνία σε στενό χρονικό παράθυρο και θεωρήστε μια αντιστοιχία ως «βρέθηκε». Άχαρο, αλλά πολύ φθηνότερο από ένα διπλότυπο.

Ένας πίνακας αποφάσεων με τον οποίο μπορείτε να διαφωνήσετε

Τι βλέπετεΤι ξέρετεΤι να κάνετεΤι να μην κάνετε
Ο προμηθευτής επιστρέφει «ο ναύλος άλλαξε»Δεν κρατήθηκε τίποταΔείξτε το νέο σύνολο, ζητήστε αποδοχή, ξανατρέξτε τη δημιουργίαΝα ξανατρέξετε με την παλιά τιμή ελπίζοντας ότι θα περάσει
Επιτυχία, αλλά το σύνολο διαφέρει από αυτό που αποδέχτηκε ο πελάτηςΥπάρχει κράτηση στη νέα τιμήΚρατήστε την πληρωμή, ρωτήστε τον πελάτη, ακυρώστε την κράτηση αν αρνηθείΝα εισπράξετε το παλιό ποσό και να απορροφήσετε τη διαφορά
Η πληρωμή εισπράχθηκε, η κλήση έκδοσης δίνει σφάλμαΥπάρχει PNR, η κατάσταση εισιτηρίου άγνωστηΞαναδιαβάστε την κράτηση, επαναλάβετε την έκδοση μέσα στο χρονικό όριο, επιστρέψτε τα χρήματα μετάΝα σημάνετε την κράτηση ως αποτυχημένη και να ξεχάσετε το PNR
Timeout στη δημιουργίαΑποτέλεσμα άγνωστοΑναζήτηση με τη δική σας αναφορά, μετά συνέχεια ή μία επανάληψηΆμεση τυφλή επανάληψη
Timeout στην ακύρωσηΊσως εξακολουθείτε να ευθύνεστε για το τμήμαΞαναδιαβάστε την κατάσταση πριν πείτε οτιδήποτε στον πελάτηΝα δείξετε «ακυρώθηκε» επειδή έγινε το κλικ

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

Πόσο κοστίζει να το κάνετε λάθος

Κάθε αστοχία έχει διαφορετικό λογαριασμό. Μια χαμένη αλλαγή τιμής είναι περιθώριο που χάνεται σε κάθε κράτηση που αγγίζει, συχνά απαρατήρητο ως τον συμφωνισμό. Μια κράτηση χωρίς έκδοση είναι ένας πελάτης που φτάνει στο αεροδρόμιο με κράτηση που έληξε και χρέωση στην κάρτα του, δηλαδή chargeback και πρόβλημα φήμης μαζί. Μια τυφλή επανάληψη σε timeout είναι διπλή κράτηση, και οι αεροπορικές ελέγχουν τα διπλότυπα· ένα μοτίβο τους είναι από τα πράγματα που καταλήγουν σε ADM.

Τίποτα από αυτά δεν είναι εξωτικό. Είναι η άχαρη υδραυλική που ξεχωρίζει ένα demo από κάτι που μπορείτε να αφήσετε να τρέχει όλο το Σαββατοκύριακο.

Φτιάξτε την εργασία συμφωνισμού πριν τη χρειαστείτε

Και οι τρεις αστοχίες καταλήγουν στο ίδιο: η βάση σας και αυτή του προμηθευτή διαφωνούν. Γράψτε λοιπόν την εργασία που τις συγκρίνει πριν από το πρώτο συμβάν, όχι μετά. Μια νυχτερινή εκτέλεση είναι το ελάχιστο· κάθε λίγα λεπτά για ό,τι βρίσκεται σε μεταβατική κατάσταση είναι καλύτερο. Απαριθμεί τις κρατήσεις που έχουν κολλήσει σε αναμονή, έκδοση ή άγνωστη κατάσταση, ρωτά τον προμηθευτή τι πιστεύει και είτε διορθώνει την εγγραφή είτε ανοίγει αίτημα με τα στοιχεία επισυναπτόμενα.

Κρατήστε κάθε αίτημα και απάντηση των κλήσεων κράτησης, μαζί με τα timeouts, με την αναφορά που στείλατε. Όταν ένας πελάτης αμφισβητεί μια χρέωση, αυτό το αρχείο είναι το επιχείρημά σας. Κρατά επίσης τίμια τη συζήτηση για την καθυστέρηση: δείτε τι μπορείτε και τι δεν μπορείτε να διορθώσετε στην καθυστέρηση του API για το γιατί τα timeouts είναι γεγονός της ζωής και όχι σφάλμα προς εξάλειψη.

Αν αποφασίζετε ακόμη πώς θα συνδέσετε τον ίδιο τον προμηθευτή, ο οδηγός ενσωμάτωση API κράτησης πτήσεων καλύπτει τη σειρά κλήσεων που προϋποθέτει αυτό το άρθρο. Και αν θέλετε να συζητήσετε πώς αντιστοιχούν αυτές οι καταστάσεις στα API πτήσεων και ξενοδοχείων μας, η πρόσβαση ξεκινά ως συζήτηση: δείτε τη σελίδα των travel API.

Σύνταξη Tekravel

Τμήμα τεχνολογιών ταξιδιού

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