Σε αυτή τη σελίδα
Μια ενημέρωση παραγγελίας φτάνει πριν από το γεγονός δημιουργίας της. Αλλού, ένα γεγονός πληρωμής φτάνει πριν από ένα παλαιότερο γεγονός συνδρομής. Πρόκειται για υποθετικές ομάδες με διαφορετικά προϊόντα και payloads. Και οι δύο μπαίνουν στον πειρασμό να διορθώσουν το ζήτημα ταξινομώντας τις παραδόσεις με βάση την ώρα άφιξης.
Δεν περιγράφεται πραγματικό περιστατικό καμίας ομάδας. Η ερώτηση είναι αν οι αστοχίες έχουν κοινό σχήμα παρότι οι λεπτομέρειες των παρόχων διαφέρουν.
Μια καταγεγραμμένη συζήτηση για μαθηματικές συνδέσεις παρατηρεί ότι προβλήματα που φαίνονται διαφορετικά μπορεί να μοιράζονται χρήσιμη μορφή. Η εφαρμογή της ιδέας στις ενσωματώσεις λογισμικού είναι δική μας συναγωγή. Γίνεται χρήσιμη μόνο όταν η κοινή μορφή παράγει δοκιμή που στηρίζει η τεκμηριωμένη συμπεριφορά κάθε συστήματος.
Αφαιρέστε τα ονόματα και μετά ξαναβάλτε τις συμβάσεις
Περιγράψτε την πρώτη περίπτωση χωρίς ονόματα προϊόντων: ένα γεγονός για πόρο μπορεί να φτάσει μετά από μεταγενέστερη αλλαγή του ίδιου πόρου. Ένας δέκτης που θεωρεί τη σειρά άφιξης σειρά κατάστασης μπορεί να αντικαταστήσει νέα πληροφορία με παλιά.
Τώρα εξετάστε τις δύο πραγματικές συμβάσεις. Η τεκμηρίωση webhooks του Shopify λέει ότι η σειρά δεν είναι εγγυημένη, ακόμη και μέσα στο ίδιο θέμα, και δίνει παράδειγμα όπου ενημέρωση προϊόντος φτάνει πριν από την παράδοση δημιουργίας του. Η τεκμηρίωση webhooks του Stripe λέει επίσης ότι η σειρά παράδοσης μπορεί να διαφέρει από τη σειρά παραγωγής και συνιστά ανάκτηση αντικειμένων που λείπουν όταν δεν έχει φτάσει αναμενόμενο προηγούμενο γεγονός.
Shopify και Stripe προειδοποιούν ότι η σειρά παράδοσης δεν είναι εγγυημένη. Η κοινή ερώτηση αφορά τη σωστή τελική κατάσταση. Τα αναγνωριστικά και οι κανόνες αποκατάστασης κάθε παρόχου χρειάζονται δική τους δοκιμή.
Η μεταφέρσιμη ερώτηση είναι: «Αν αυτό το γεγονός φτάσει πριν από ένα σχετικό, μπορούμε ακόμη να συναγάγουμε τη σωστή τρέχουσα κατάσταση;» Η απάντηση υλοποίησης δεν μεταφέρεται με υπόθεση. Το Shopify τεκμηριώνει κεφαλίδες όπως X-Shopify-Webhook-Id και χρονικές σημάνσεις. Το Stripe χρησιμοποιεί δικά του ID γεγονότων και κανόνες ανάκτησης αντικειμένων. Ένα αναγνωριστικό που σημαίνει «παράδοση» σε ένα σύστημα μπορεί να μη σημαίνει το ίδιο σε άλλο.
Ο οδηγός συνδέσμου Brevo εξετάζει διαφορετικές λεπτομέρειες πεδίων και αντιστοίχισης. Έχουν σημασία για λειτουργική ενσωμάτωση, αλλά δεν πρέπει να θεωρούνται καθολική συμπεριφορά API.
Το κοινό σχήμα είναι μια ιδιότητα που πρέπει να ισχύει
Σε συγχρονισμό πελατών, η ιδιότητα μπορεί να είναι: μετά την επεξεργασία, η εγγραφή πελάτη στον προορισμό αντανακλά την τρέχουσα κατάσταση της εξουσιοδοτημένης πηγής. Στην τιμολόγηση μπορεί να είναι: ενέργεια που εξαρτάται από πληρωμή συμβαίνει μόνο όταν το αρμόδιο σύστημα πληρωμών το επιτρέπει. Η ιδιότητα ορίζει τι πρέπει να παραμένει αληθινό ακόμη κι όταν τα γεγονότα καθυστερούν, επαναλαμβάνονται ή είναι ελλιπή.
Καταγράψτε τέσσερα πράγματα πριν επιλέξετε διόρθωση:
| Ερώτηση | Γιατί έχει σημασία |
|---|---|
| Ποια ταυτότητα ονομάζει το επιχειρηματικό αντικείμενο; | Το ID γεγονότος μπορεί να ταυτοποιεί μήνυμα, όχι πελάτη ή παραγγελία. |
| Ποιο σύστημα ορίζει την τρέχουσα κατάσταση; | Το payload μπορεί να είναι στιγμιότυπο, αλλαγή ή απλώς δείκτης. |
| Τι χρονικές εγγυήσεις δίνει η πηγή; | Η σειρά παράδοσης μπορεί να μη δείχνει σειρά κατάστασης. |
| Ποια τελική συνθήκη αποδεικνύει επιτυχία; | Η λήψη γεγονότος δεν αποδεικνύει σωστό προορισμό. |
Ο πίνακας βοηθά τη σκέψη, δεν είναι πρωτόκολλο. Η απάντηση για την πηγή αλήθειας εξαρτάται από τη ροή. Σε ένα σύστημα ίσως απαιτείται ζωντανή αναζήτηση, σε άλλο ίσως είναι ακατάλληλη. Μερικά γεγονότα πρέπει να διατηρούνται ως ιστορικά στοιχεία και όχι να συμπτύσσονται στο πιο πρόσφατο στιγμιότυπο.
Επαναχρησιμοποιήστε τη δοκιμή, προσαρμόστε τη θεραπεία
Μια μικρή δοκιμή σύμβασης μπορεί να στείλει σχετικά γεγονότα σε αντίστροφη σειρά και να εξετάσει αν η τελική κατάσταση προορισμού είναι σωστή. Άλλη μπορεί να στείλει την ίδια παράδοση δύο φορές. Αυτές οι δοκιμές αποκαλύπτουν το σχήμα του κινδύνου. Έπειτα η τεκμηρίωση του παρόχου καθορίζει πώς ταυτοποιείται, επαληθεύεται και αποκαθίσταται κάθε γεγονός.
Η διάκριση προστατεύει τις ομάδες από αρχιτεκτονική αντιγραφής. Ένα κλειδί αποδιπλοποίησης από ένα API μπορεί να αποτύχει σε άλλο. Μια χρονική σήμανση χαμηλής ακρίβειας μπορεί να μην καθορίζει τη σειρά. Η ανάκτηση του τρέχοντος αντικειμένου μπορεί να χρειάζεται σε συγχρονισμό κατάστασης, αλλά δεν ανασυνθέτει κάθε ενδιάμεσο ιστορικό γεγονός. Ο οδηγός ενσωμάτωσης πολλών εργαλείων αρχίζει επιλέγοντας ποιο σύστημα ορίζει κάθε πεδίο. Χωρίς αυτή την επιλογή, το «νεότερο» δεν έχει σαφές νόημα.
Η μεταφορά μοτίβων έχει όριο. Παρόμοια συμπτώματα μπορεί να έχουν άλλες αιτίες: μια εγγραφή που λείπει ίσως οφείλεται σε μη εξουσιοδοτημένο ερώτημα, καθυστερημένο webhook, άκυρη αντιστοίχιση ή απορριφθείσα εγγραφή. Πριν κρίνετε δύο περιπτώσεις ισοδύναμες, συγκρίνετε σύμβαση πηγής, σύμβαση προορισμού και παρατηρημένη τελική συνθήκη. Αν μία διαφέρει, κρατήστε την κοινή ερώτηση και αλλάξτε τη δοκιμή.
Η μέθοδος χρησιμεύει πέρα από την παράδοση γεγονότων. Ένα πεδίο που έγινε δεκτό από API αλλά λείπει από την εγγραφή που βλέπει ο χρήστης θέτει την ίδια γενική ερώτηση σε κάθε σύνδεσμο: τι αποδεικνύει η επιβεβαίωση και τι αποδεικνύει την επιδιωκόμενη κατάσταση; Η απάντηση μπορεί να απαιτεί ανάγνωση προορισμού, αναζήτηση σχήματος ή έλεγχο άδειας. Το μοτίβο μάς λέει να ξεχωρίζουμε τη μεταφορά από το νόημα. Δεν λέει ποιο πεδίο ή endpoint θα καλέσουμε. Αυτό το στενότερο δίδαγμα μεταφέρεται πιο μακριά, επειδή κρατά ορατά τα τοπικά γεγονότα.
Το ισχυρότερο επαναχρησιμοποιήσιμο δίδαγμα δεν είναι κομμάτι κώδικα. Είναι ερώτηση που επιβιώνει στη μεταφορά σε άλλο σύστημα και κάνει ευκολότερη την εξέταση της τοπικής σύμβασης.
Έχετε Ερωτήσεις; Έχουμε Απαντήσεις
Μπορεί η ίδια δοκιμή ενσωμάτωσης να χρησιμοποιηθεί σε διαφορετικούς παρόχους;
Η ερώτηση συχνά μεταφέρεται, όπως αν οι ενημερώσεις μπορούν να φτάσουν εκτός σειράς. Τα ID γεγονότων, το νόημα του payload, οι υπογραφές και τα βήματα αποκατάστασης πρέπει να προκύπτουν από τη σύμβαση κάθε παρόχου.
Ποια είναι η διαφορά ανάμεσα σε μοτίβο και αντιγραμμένη διόρθωση;
Το μοτίβο ονομάζει την κατάσταση αστοχίας και την ιδιότητα που πρέπει να διατηρηθεί. Η αντιγραμμένη διόρθωση υποθέτει χωρίς έλεγχο ότι το δεύτερο σύστημα έχει ίδια αναγνωριστικά, σειρά και σημασιολογία κατάστασης.
Τι πρέπει να ελέγχεται μετά την εφαρμογή γεγονότος;
Ελέγξτε την κατάσταση προορισμού που απαιτεί η ροή, όχι μόνο τη λήψη γεγονότος ή την απάντηση HTTP. Η τελική συνθήκη εξαρτάται από το επιχειρηματικό αντικείμενο και τον κανόνα πηγής αλήθειας.