Πριν προσλάβετε εταιρεία ενσωμάτωσης API στο Ντουμπάι

Στο γραφείο υπάρχουν τρεις προσφορές. Κάθε εταιρεία ενσωμάτωσης έχει ένα portfolio με ταξιδιωτικά sites, κάθε μία υπόσχεται να «συνδέσει ένα API πτήσεων με το site σας», και η φθηνότερη μπορεί να ξεκινήσει την επόμενη εβδομάδα. Έχετε ταξιδιωτικό γραφείο στη Ντέιρα, έξι υπαλλήλους και σταθερό εταιρικό πελατολόγιο, και έχετε κουραστεί να αντιγράφετε ναύλους από το extranet του προμηθευτή σε μηνύματα WhatsApp. Η επιλογή της εταιρείας ενσωμάτωσης API στο Ντουμπάι που φαίνεται πιο ικανή μοιάζει να είναι όλη η απόφαση.
Είναι περίπου το ένα τρίτο. Ό,τι κρίνει αν το site θα πουλάει δεν βρίσκεται σε καμία από τις τρεις προσφορές, γιατί δεν είναι κώδικας. Είναι με ποιον υπογράφηκε η σύμβαση προμήθειας, στο όνομα ποιου εκδίδονται τα εισιτήρια, πού βρίσκονται τα χρήματα ανάμεσα στην κράτηση και την έκδοση, και ποιος χειρίζεται την επιστροφή χρημάτων όταν ο πελάτης ακυρώνει. Ένας integrator μπορεί να τα συνδέσει όλα αυτά. Δεν μπορεί να είναι κανένα από αυτά για λογαριασμό σας.
Το κείμενο απευθύνεται στον ιδιοκτήτη που θα υπογράψει το αντικείμενο του έργου, όχι στον προγραμματιστή που θα το διαβάσει.
Τι μπορεί να παραδώσει μια εταιρεία ενσωμάτωσης API στο Ντουμπάι, και τι όχι
Μια εταιρεία ενσωμάτωσης γράφει τον κώδικα ανάμεσα στο API ενός προμηθευτή και στο site σας: τη φόρμα αναζήτησης, την κλήση που ρωτά για διαθεσιμότητα, τον έλεγχο τιμής πριν από την πληρωμή, το αίτημα κράτησης, τις οθόνες με το αποτέλεσμα και, αν το προβλέπει το έργο, τις κλήσεις ακύρωσης και επιστροφής. Οι καλές αναλαμβάνουν και τα βαρετά που μετράνε: επανάληψη όταν ο προμηθευτής αργεί να απαντήσει, logs που επιτρέπουν να εντοπιστεί μια αποτυχημένη κράτηση, ένα περιβάλλον δοκιμών που συμπεριφέρεται όπως η παραγωγή.
Αυτό που δεν μπορεί να σας δώσει είναι όλα όσα βρίσκονται στην άλλη πλευρά του κώδικα. Πριν γραφτεί η πρώτη γραμμή, το γραφείο χρειάζεται:
- έναν λογαριασμό στον προμηθευτή στο όνομα του ίδιου του γραφείου, με πρόσβαση στο API για αυτόν τον λογαριασμό·
- δικαίωμα έκδοσης: δική του διαπίστευση ή έναν consolidator που εκδίδει για λογαριασμό του·
- μια οικονομική συμφωνία με τον προμηθευτή: εγγύηση, πιστωτικό όριο ή πληρωμές με κάρτα που μεταβιβάζονται·
- κάποιον που κάνει τη δουλειά μετά το εισιτήριο (voids, επιστροφές, επανεκδόσεις, αλλαγές δρομολογίων), μέσω API ή, αν δεν γίνεται, με το χέρι.
Ο integrator που προσφέρεται να «τακτοποιήσει την πλευρά του προμηθευτή» συνήθως προσφέρεται να σας δανείσει τη δική του. Για ένα πρωτότυπο, μπορεί να είναι λογική συντόμευση. Για μια επιχείρηση, σημαίνει ότι το site κρατήσεών σας λειτουργεί πάνω σε μια σχέση που δεν σας ανήκει και που δεν την παίρνετε μαζί σας όταν φύγετε.
Το brief: επτά γραμμές για το αντικείμενο του έργου
Οι περισσότερες διαφωνίες με έναν integrator ξεκινούν από μια πρόταση που δεν έγραψε κανείς. Βάλτε αυτές στο έγγραφο που υπογράφετε, με απλά λόγια, και ζητήστε κάθε απάντηση γραπτώς.
- Στο όνομα ποιου είναι ο λογαριασμός στον προμηθευτή και τα κλειδιά API. Του γραφείου. Τα κλειδιά είναι διαπιστευτήρια: φυλάσσονται στο δικό σας θησαυροφυλάκιο κωδικών, και ο integrator παίρνει πρόσβαση, όχι κυριότητα.
- Ποιος φιλοξενεί το site και ποιος κατέχει το domain. Το domain είναι καταχωρισμένο στο γραφείο. Ο λογαριασμός φιλοξενίας ανήκει στο γραφείο, ή η σύμβαση λέει ακριβώς πώς μεταβιβάζεται.
- Ποιες λειτουργίες περιλαμβάνονται. Γράψτε τις ονομαστικά: αναζήτηση, τιμή, κράτηση, έκδοση, ακύρωση, επιστροφή, αλλαγή. Ό,τι δεν είναι στη λίστα μένει, για όσο ζει το site, ένα email προς το γκισέ του προμηθευτή. Οι επιστροφές και οι αλλαγές λείπουν πιο συχνά, γιατί καμία παρουσίαση δεν τις δείχνει.
- Ποιος συντηρεί την ενσωμάτωση όταν ο προμηθευτής αλλάζει το API. Οι προμηθευτές αποσύρουν εκδόσεις και μετονομάζουν πεδία. Ένα έργο σταθερής τιμής χωρίς ρήτρα συντήρησης τελειώνει τη μέρα που αλλάζει η πρώτη έκδοση.
- Τι σημαίνει παράδοση. Πηγαίος κώδικας σε repository που ανήκει στο γραφείο, όλα τα διαπιστευτήρια και τεκμηρίωση με την οποία άλλος προγραμματιστής μπορεί να συνεχίσει τη δουλειά. Το «θα σας στείλουμε ένα zip» δεν είναι παράδοση.
- Πώς αποδεικνύεται ότι είναι έτοιμο. Μια δοκιμαστική κράτηση από την αναζήτηση ως το εισιτήριο στο περιβάλλον δοκιμών του προμηθευτή, μαζί με μια ακύρωση, πριν χρεωθεί η κάρτα πραγματικού πελάτη.
- Τι γίνεται με τα δεδομένα των πελατών. Ονόματα επιβατών, στοιχεία διαβατηρίου, αναφορές πληρωμών: πού αποθηκεύονται, ποιος μπορεί να τα διαβάσει και πώς διαγράφονται.
Κανένα από αυτά δεν χρειάζεται τεχνικές γνώσεις για να γραφτεί. Κάθε ένα κοστίζει λιγότερο να συμφωνηθεί πριν από την κατασκευή παρά να διαπραγματευτεί μετά.
Τρεις δρόμοι για να φτάσει περιεχόμενο προμηθευτών στο site σας
Η πρόσληψη integrator πάνω στο API ενός προμηθευτή είναι ένας δρόμος. Αξίζει να τον δείτε δίπλα στους άλλους δύο πριν μια προσφορά διαλέξει για εσάς.
| Δρόμος | Ποιος έχει τη σχέση με τον προμηθευτή | Ποιος κρατά τη σύνδεση σε λειτουργία | Τι πρέπει ακόμα να φτιάξει το γραφείο | Πόσο κοστίζει η αποχώρηση |
|---|---|---|---|---|
| Ο integrator συνδέει το site σας με το API ενός προμηθευτή | Το γραφείο, αν το λέει το brief· αλλιώς συχνά ο integrator | Ο integrator με σύμβαση συντήρησης, ή κανείς | Διαχείριση, markups, αρχείο πελατών, αναφορές, πληρωμές, οθόνες εξυπηρέτησης μετά την πώληση | Λίγο αν ο κώδικας και τα κλειδιά είναι δικά σας· ξαναχτίσιμο αν δεν είναι |
| Ο integrator συνδέει το site σας με το API μιας πλατφόρμας | Η πλατφόρμα έχει τις συμβάσεις με προμηθευτές· το γραφείο έχει τον λογαριασμό του στην πλατφόρμα | Η πλατφόρμα στην πλευρά του προμηθευτή· ο integrator στη δική σας | Το site σας, και ό,τι δεν καλύπτει το API της πλατφόρμας | Επανεγγραφή της δικής σας πλευράς σε άλλο API |
| Κατάστημα white-label ήδη συνδεδεμένο | Η πλατφόρμα, μέσω του λογαριασμού του γραφείου | Η πλατφόρμα | Περιεχόμενο, αποφάσεις τιμολόγησης, τους δικούς σας πελάτες | Μεταφορά του domain και της λίστας πελατών σε άλλον πάροχο |
Η γραμμή που αξίζει συζήτηση είναι η πρώτη. Δίνει τον περισσότερο έλεγχο και φορτώνει τα περισσότερα σε εσάς: κάθε αλλαγή του προμηθευτή, κάθε νέα υπηρεσία και κάθε λειτουργία που έμεινε έξω από την πρώτη κατασκευή γίνεται άλλο ένα έργο με άλλη μία προσφορά.
Πώς βάζετε αναζήτηση σε ένα site που ήδη έχετε εξηγείται στο προσθήκη αναζήτησης πτήσεων σε υπάρχουσα ιστοσελίδα, και ποιανού το API μπαίνει από πίσω στο τι βρίσκεται πίσω από έναν πάροχο API κρατήσεων πτήσεων. Αυτό το κείμενο αφορά τη σύμβαση γύρω από τη δουλειά.
Πού βρίσκεται αυτή η πλατφόρμα
Η πλατφόρμα πίσω από αυτό το blog διαθέτει API πτήσεων και ξενοδοχείων. Η πρόσβαση ξεκινά με μια συζήτηση και όχι με ένα κλειδί που παίρνετε μόνοι σας, γιατί οι πρώτες ερωτήσεις είναι οι παραπάνω (ποιες υπηρεσίες, ποια αγορά, πώς κινούνται τα χρήματα) και όχι ποιο endpoint θα καλέσετε. Οι υπηρεσίες ενεργοποιούνται ανά λογαριασμό, και κάθε λογαριασμός έχει δικό του πίνακα διαχείρισης με δικές του κρατήσεις, πελάτες, markups και αναφορές, οπότε η στήλη «τι πρέπει ακόμα να φτιάξει» στη δεύτερη γραμμή είναι πιο σύντομη απ' όσο φαίνεται.
Αν μια εταιρεία ενσωμάτωσης θα φτιάξει τη δική σας πλευρά, κάντε αυτή τη συζήτηση πριν δεχτείτε προσφορά, ώστε το έργο να περιγράφει το API στο οποίο θα συνδεθεί πραγματικά. Η αρχή γίνεται στη σελίδα με τα ταξιδιωτικά API.
Τι σας κοστίζει ένα αδύναμο brief
Το site βγαίνει στον αέρα. Η αναζήτηση δουλεύει, οι τιμές φαίνονται σωστές, και η πρώτη κράτηση έρχεται Πέμπτη βράδυ. Δεν μπορεί να εκδοθεί στο όνομα του γραφείου σας, γιατί ο λογαριασμός στον προμηθευτή ανήκει στον integrator και εκδίδει με τη δική του συμφωνία. Η κάρτα του πελάτη έχει ήδη χρεωθεί. Τώρα έχετε μια κράτηση που δεν μπορείτε ούτε να εκδώσετε ούτε να επιστρέψετε μέσα από το δικό σας site.
Ή λειτουργεί για έναν χρόνο. Μετά ο προμηθευτής περνά σε νέα έκδοση API, οι κρατήσεις σταματούν, και ο integrator, του οποίου η σύμβαση σταθερής τιμής έληξε με την παράδοση, στέλνει προσφορά για νέο έργο. Πληρώνετε, γιατί οι μόνοι που καταλαβαίνουν τον κώδικα είναι αυτοί που κάνουν την προσφορά.
Ή ο integrator απλώς είναι απασχολημένος αλλού. Ένας πελάτης χρειάζεται διόρθωση ονόματος σε εισιτήριο, η λειτουργία αλλαγής δεν μπήκε ποτέ στο έργο, και δύο υπάλληλοί σας περνούν το απόγευμα στέλνοντας email στο γκισέ του προμηθευτή. Ακριβώς η δουλειά που το site έπρεπε να σας γλιτώσει.
Κάθε φορά έλειπε μία πρόταση από το brief. Ο κώδικας ήταν εντάξει κάθε φορά.