Δωρεάν API κρατήσεων ξενοδοχείων: τι παίρνεις πραγματικά

Είναι Πέμπτη απόγευμα και η παρουσίαση είναι τη Δευτέρα. Βρήκες ένα δωρεάν API κρατήσεων ξενοδοχείων, εγγράφηκες με μια διεύθυνση email και είχες κλειδί σε πέντε λεπτά. Το endpoint αναζήτησης επιστρέφει ξενοδοχεία με φωτογραφίες, αστέρια και τιμή ανά βράδυ. Ως το βράδυ η σελίδα αποτελεσμάτων δείχνει όπως πρέπει. Την Παρασκευή συνδέεις την κλήση κράτησης και απαντά με ένα σφάλμα που δεν μπορείς να διαβάσεις, γιατί αυτό για το οποίο εγγράφηκες δεν μπόρεσε ποτέ να κάνει κράτηση.
Κανείς δεν είπε ψέματα. Το «δωρεάν» απλώς κολλάει σε τέσσερα διαφορετικά προϊόντα αυτής της αγοράς, και οι σελίδες εγγραφής δεν σου λένε ποιο κρατάς στα χέρια σου.
Τέσσερα πράγματα που μπορεί να σημαίνει το «δωρεάν»
Ο πίνακας αξίζει να μένει δίπλα στο πληκτρολόγιο. Αν διαφωνείς με κάποια γραμμή επειδή ο προμηθευτής σου λειτουργεί αλλιώς, κι αυτό είναι χρήσιμο εύρημα.
| Τι είναι η δωρεάν προσφορά | Τι παίρνεις | Τι μπορείς να χτίσεις | Τι δεν μπορεί να κάνει |
|---|---|---|---|
| Στατικό περιεχόμενο ή δεδομένα καταλόγου | Ονόματα ξενοδοχείων, διευθύνσεις, φωτογραφίες, παροχές, περιγραφές | Οδηγό ξενοδοχείων, χάρτη, σελίδα προορισμού | Να δείξει τιμή που μπορείς να τηρήσεις ή δωμάτιο που είναι πράγματι ελεύθερο στις ημερομηνίες σου |
| Αναζήτηση συνεργάτη με ανακατεύθυνση | Ξενοδοχεία και τιμές, συν σύνδεσμο προς το ταμείο του πωλητή | Σελίδα σύγκρισης που στέλνει την κίνηση αλλού | Να κρατήσει τον πελάτη, την πληρωμή ή την εγγραφή κράτησης σε εσένα |
| Sandbox με δοκιμαστικές τιμές | Ολόκληρη τη ροή αναζήτησης, τιμής, κράτησης και ακύρωσης με φανταστική διαθεσιμότητα | Μια λειτουργική ενσωμάτωση και ένα demo που συμπεριφέρεται σαν παραγωγή | Να δημιουργήσει κράτηση που θα τιμήσει ένα πραγματικό ξενοδοχείο |
| Ζωντανές κρατήσιμες τιμές | Πραγματικά δωμάτια σε πραγματικές τιμές net ή πώλησης, επιβεβαιωμένα από τον προμηθευτή | Ένα κατάστημα που εισπράττει χρήματα για δωμάτια | Να είναι δωρεάν για αυτόν που υπογράφει το συμβόλαιο |
Τα τρία πρώτα είναι δωρεάν γιατί στον πάροχο κοστίζει σχεδόν τίποτα να τα χαρίσει. Το τέταρτο δεν είναι δωρεάν γιατί κάποιος φέρει κάτι πραγματικό.
Γιατί μια κρατήσιμη τιμή έρχεται πάντα με συμβόλαιο
Όταν ο πελάτης σου πληρώνει ένα δωμάτιο, ξεκινά μια αλυσίδα υποχρεώσεων. Ένας προμηθευτής έχει το συμβόλαιο με το ξενοδοχείο. Ο προμηθευτής έχει υποσχεθεί στο ξενοδοχείο ότι το δωμάτιο θα πληρωθεί και σε εσένα ότι το δωμάτιο υπάρχει. Αν ο επισκέπτης ακυρώσει μετά την προθεσμία δωρεάν ακύρωσης, κάποιος οφείλει στο ξενοδοχείο μια νύχτα. Αν η τιμή ήταν λάθος, κάποιος απορροφά τη διαφορά. Αν η κάρτα ήταν κλεμμένη, κάποιος ευθύνεται για την επιστροφή χρημάτων.
Όλα αυτά πρέπει να καταλήξουν σε ένα ονομαστικό μέρος. Ένα κλειδί API που οποιοσδήποτε μπορεί να δημιουργήσει με μια διεύθυνση email δεν μπορεί να τα σηκώσει, γι’ αυτό η κρατήσιμη πρόσβαση έρχεται με συμφωνία, ρύθμιση εκκαθάρισης και συχνά πιστωτικό όριο. Το τίμημα του «δωρεάν» κλειδιού είναι ότι ο πάροχος δεν χρειάζεται να νοιάζεται τι θα το κάνεις.
Τίποτα από αυτά δεν είναι κριτική στα δωρεάν επίπεδα. Μια ροή περιεχομένου είναι ακριβώς σωστή για έναν οδηγό προορισμού. Γίνεται λάθος μόνο όταν τη μπερδεύεις με αυτό που χρειάζεσαι για να δεχτείς κράτηση.
Αν αποφασίζεις και πόσους προμηθευτές χρειάζεσαι πίσω από αυτόν που θα διαλέξεις, το εξετάσαμε στο άρθρο πόσους παρόχους API ξενοδοχείων χρειάζεστε· η εκδοχή για πτήσεις της ίδιας σύγχυσης βρίσκεται στο άρθρο τα τρία είδη δωρεάν API πτήσεων.
Υπάρχει και μια ακόμη παγίδα μέσα στην πρώτη γραμμή. Το στατικό περιεχόμενο και οι ζωντανές τιμές είναι δύο ροές με διαφορετική διάρκεια ζωής: η περιγραφή ενός ξενοδοχείου μπορεί να μείνει στην κρυφή μνήμη για εβδομάδες, η τιμή για απόψε δεν μπορεί να μείνει ούτε λεπτά. Μια δωρεάν ροή περιεχομένου που δείχνει και τιμή παραθέτει έναν αριθμό που δεν εγγυάται, και μια σελίδα χτισμένη πάνω της θα δείξει ανέμελα ένα δωμάτιο που πουλήθηκε χθες.
Τι να δοκιμάσεις σε sandbox πριν υπογραφεί οποιοδήποτε συμβόλαιο
Το sandbox είναι το πιο χρήσιμο δωρεάν πράγμα του πίνακα, γι’ αυτό χρησιμοποίησέ το στο έπακρο. Ένα καλό σε αφήνει να κάνεις κάθε βήμα μιας πραγματικής κράτησης, με ψεύτικη διαθεσιμότητα αλλά με πραγματική μορφή.
- Αναζήτηση με παιδιά και πολλά δωμάτια. Η πληρότητα είναι το σημείο όπου χαλάνε πρώτες οι απλές ενσωματώσεις. Ζήτησε δύο δωμάτια με διαφορετικούς επισκέπτες και δες αν η απάντηση τα κρατά ξεχωριστά.
- Έλεγχος τιμής πριν την κράτηση. Πολλοί προμηθευτές περιμένουν μια δεύτερη κλήση που επιβεβαιώνει ότι η τιμή ισχύει ακόμη. Αν το sandbox δεν έχει τέτοιο βήμα, ρώτα αν το έχει η παραγωγή.
- Κάνε κράτηση και μετά διάβασε τι επιστρέφει. Ένα επιβεβαιωμένο δωμάτιο, ένα εκκρεμές αίτημα και ένα δωμάτιο κατόπιν αιτήματος είναι τρία διαφορετικά αποτελέσματα, και η οθόνη σου πρέπει να λέει ποιο.
- Άλλαξε την τιμή ανάμεσα στην αναζήτηση και την κράτηση. Οι τιμές κινούνται. Πώς μοιάζει το σφάλμα και μπορεί ο κώδικάς σου να δείξει στον πελάτη τη νέα τιμή αντί για κενή σελίδα;
- Ακύρωσε μέσα και έξω από το δωρεάν παράθυρο. Η πολιτική ακύρωσης πρέπει να έρχεται ως δομημένα δεδομένα με ημερομηνίες και ποσά, όχι ως παράγραφος που πρέπει να αναλύσεις.
- Αποτυχία εσκεμμένα. Στείλε λάθος ημερομηνία, άγνωστο κωδικό ξενοδοχείου, ληγμένο token. Μέτρα πόσες διαφορετικές μορφές σφάλματος παίρνεις πίσω.
Αν το sandbox δεν μπορεί να κάνει τα βήματα τέσσερα και πέντε, έχεις ένα API περιεχομένου με URL σε σχήμα κράτησης.
Τι κοστίζει το χτίσιμο πάνω στο λάθος είδος
Η ακριβή εκδοχή του λάθους δεν είναι η εβδομάδα που χάνεις. Είναι το demo που πάει καλά.
Δείχνεις σε έναν ενδιαφερόμενο μια καθαρή σελίδα αναζήτησης, εγκρίνει τον προϋπολογισμό και μόνο τότε η ομάδα ανακαλύπτει ότι η πηγή πίσω της δεν μπορεί να επιβεβαιώσει δωμάτιο. Ο κώδικας δεν πάει όλος χαμένος, αλλά η ροή κράτησης, το βήμα πληρωμής, ο χειρισμός ακυρώσεων και η εκκαθάριση πρέπει να χτιστούν πάνω σε άλλον προμηθευτή, με άλλα ονόματα πεδίων. Η σελίδα αναζήτησης που έδειξες θα επιστρέφει τότε άλλα ξενοδοχεία, σε άλλες τιμές, με άλλη σειρά. Όποιος ενέκρινε τον προϋπολογισμό θα το προσέξει.
Η φθηνότερη συνήθεια είναι να κάνεις μία ερώτηση πριν γράψεις κώδικα: «Μπορεί αυτό το κλειδί να δημιουργήσει κράτηση που θα τιμήσει ένα ξενοδοχείο και να την ακυρώσει μετά;» Αν η απάντηση είναι οτιδήποτε άλλο εκτός από ναι, ξέρεις ποιο από τα τέσσερα κρατάς.
Πού βρίσκεται αυτή η πλατφόρμα
Οφείλουμε να είμαστε το ίδιο ευθείς για τη δική μας θέση όπως ήμασταν για τις άλλες. Η πλατφόρμα προσφέρει API πτήσεων και ξενοδοχείων, και η πρόσβαση ξεκινά ως συζήτηση και όχι ως κλειδί αυτοεξυπηρέτησης. Αυτή είναι η τέταρτη γραμμή του πίνακα: πίσω από την κρατήσιμη διαθεσιμότητα υπάρχει κάποιος που πρέπει να ξέρει ποιος ρωτά. Αν θέλεις να δεις πώς λειτουργεί για το δικό σου project, ξεκίνα από τη σελίδα των API ταξιδιού και πες μας τι χτίζεις.
Το δωρεάν περιεχόμενο, οι σύνδεσμοι συνεργατών και τα sandbox έχουν όλα τη θέση τους, και η σωστή επιλογή εξαρτάται από το τι σκοπεύεις να πουλήσεις. Διάλεξε με βάση το τι μπορεί να κάνει το κλειδί την ημέρα που ένας πελάτης πληρώνει.