Τα API συνδέουν εφαρμογές μέσω σαφών πρωτοκόλλων και αρχιτεκτονικών. Μια αρχιτεκτονική API είναι ένα πλαίσιο κανόνων για τη δημιουργία διεπαφών λογισμικού. Οι κανόνες καθορίζουν τον τρόπο παροχής λειτουργιών διακομιστή στους χρήστες. Ο τύπος της αρχιτεκτονικής καθορίζει τους κανόνες και τις δομές που διέπουν το API.
Υπάρχουν πολλοί διαφορετικοί τύποι αρχιτεκτονικής API, από REST έως RPC. Η εκμάθηση της δομής και της σύνθεσής τους θα σας βοηθήσει να επιλέξετε ένα για την αίτησή σας.
1. ΥΠΟΛΟΙΠΟ
REST API είναι σύγχρονες και είναι η πιο δημοφιλής αρχιτεκτονική API που χρησιμοποιούν οι προγραμματιστές. ΥΠΟΛΟΙΠΟ (representational state transfer) είναι μια αρχιτεκτονική που χρησιμοποιείται για το σχεδιασμό εφαρμογών πελάτη-διακομιστή. Δεν είναι πρωτόκολλο ή πρότυπο, επομένως μπορείτε να το εφαρμόσετε με διάφορους τρόπους. Αυτή η πτυχή αυξάνει την ευελιξία σας ως προγραμματιστή.
Το REST επιτρέπει την πρόσβαση στα ζητούμενα δεδομένα που είναι αποθηκευμένα σε μια βάση δεδομένων. Μπορείτε να εκτελέσετε τις βασικές λειτουργίες CRUD με ένα REST API. Όταν οι πελάτες ζητούν περιεχόμενο μέσω ενός RESTful API, πρέπει να χρησιμοποιούν τις σωστές κεφαλίδες και παραμέτρους. Οι κεφαλίδες περιέχουν χρήσιμα μεταδεδομένα για τον προσδιορισμό ενός πόρου, όπως κωδικούς κατάστασης και εξουσιοδότηση.
Οι πληροφορίες που μεταφέρονται μέσω HTTP μπορεί να είναι σε JSON, HTML, XML ή απλό κείμενο. Το JSON είναι η πιο συχνά χρησιμοποιούμενη μορφή αρχείου για REST API. Το JSON είναι γλωσσοαγνωστικό και αναγνώσιμο από τον άνθρωπο.
2. ΣΑΠΟΥΝΙ
Απλό πρωτόκολλο πρόσβασης αντικειμένων Το (SOAP) είναι ένα επίσημο πρωτόκολλο API. Το World Wide Web Consortium (W3C) διατηρεί το πρωτόκολλο SOAP, το οποίο είναι μια από τις πρώτες αρχιτεκτονικές API. Ο σχεδιασμός του διευκολύνει την επικοινωνία μεταξύ εφαρμογών που έχουν κατασκευαστεί με διαφορετικές γλώσσες και πλατφόρμες.
Η μορφή SOAP περιγράφει ένα API χρησιμοποιώντας τη γλώσσα περιγραφής της υπηρεσίας Ιστού (WSDL). Είναι γραμμένο στην εκτενή γλώσσα σήμανσης (XML). Η μορφή επιβάλλει ενσωματωμένα πρότυπα συμμόρφωσης που ενισχύουν την ασφάλεια, τη συνέπεια, την απομόνωση και την ανθεκτικότητα. Αυτές οι ιδιότητες διασφαλίζουν αξιόπιστες συναλλαγές βάσης δεδομένων καθιστώντας το SOAP καλύτερο για την ανάπτυξη της επιχείρησης.
Όταν ένας χρήστης ζητά περιεχόμενο μέσω ενός API SOAP, περνά από τα τυπικά πρωτόκολλα επιπέδου. Η απάντηση είναι σε μορφή XML, την οποία μπορούν να διαβάσουν άνθρωποι και μηχανές. Όπως τα REST API, έτσι και τα SOAP API δεν αποθηκεύουν προσωρινά/αποθηκεύουν πληροφορίες. Εάν χρειάζεστε τα δεδομένα αργότερα, πρέπει να υποβάλετε ένα άλλο αίτημα.
Το SOAP υποστηρίζει ανταλλαγές δεδομένων τόσο με κατάσταση όσο και χωρίς πολιτεία.
3. GraphQL
Η GraphQL είναι μια γλώσσα ερωτημάτων για ένα API. Είναι ένας χρόνος εκτέλεσης από την πλευρά του διακομιστή που εκτελεί ερωτήματα με βάση ένα καθορισμένο σύνολο δεδομένων. Το GraphQL έχει συγκεκριμένες περιπτώσεις χρήσης. Η αρχιτεκτονική του σας επιτρέπει να δηλώσετε τις συγκεκριμένες πληροφορίες που χρειάζεστε.
Σε αντίθεση με την αρχιτεκτονική REST, όπου το HTTP χειρίζεται τα αιτήματα και τις απαντήσεις των πελατών, το GraphQL ζητά δεδομένα με ερωτήματα. Μια υπηρεσία GraphQL ορίζει τους τύπους και τα πεδία αυτών των τύπων και στη συνέχεια παρέχει συναρτήσεις για κάθε πεδίο και τύπο.
Η υπηρεσία λαμβάνει Ερωτήματα GraphQL για επικύρωση και εκτέλεση. Αρχικά, ελέγχει ένα ερώτημα για να βεβαιωθεί ότι αναφέρεται στους καθορισμένους τύπους και πεδία που έχουν οριστεί. Στη συνέχεια, εκτελεί τις σχετικές λειτουργίες για να παράγει το επιθυμητό αποτέλεσμα.
Το GraphQL είναι εξαιρετικό για ορισμένες περιπτώσεις χρήσης, όπως η ανάκτηση δεδομένων από πολλές πηγές. Μπορείτε επίσης να ελέγξετε την ανάκτηση δεδομένων και να ρυθμίσετε το εύρος ζώνης για μικρότερες συσκευές.
4. Απάτσι Κάφκα
Απάτσι Κάφκα είναι μια κατανεμημένη πλατφόρμα που υποστηρίζει τη ροή συμβάντων. Η ροή συμβάντων είναι η διαδικασία λήψης δεδομένων σε πραγματικό χρόνο από πηγές. Οι Πηγές μπορεί να είναι βάσεις δεδομένων, διακομιστές ή εφαρμογές λογισμικού. Το σύστημα Kafka αποτελείται από διακομιστές και πελάτες. Η επικοινωνία γίνεται μέσω πρωτοκόλλου δικτύου TCP.
Μπορείτε να αναπτύξετε το σύστημα σε υλικό, εικονικές μηχανές και κοντέινερ. Μπορείτε να το κάνετε αυτό επί τόπου και σε περιβάλλοντα cloud. Το σύστημα Apache Kafka συλλαμβάνει δεδομένα, επεξεργάζεται και αντιδρά σε αυτά σε πραγματικό χρόνο. Μπορεί επίσης να δρομολογήσει τα δεδομένα σε έναν προτιμώμενο προορισμό σε πραγματικό χρόνο. Ο Κάφκα συλλαμβάνει και αποθηκεύει δεδομένα στο σύστημα τα οποία μπορείτε να ανακτήσετε αργότερα για χρήση.
Ο Κάφκα υποστηρίζει μια συνεχή ροή και ενοποίηση δεδομένων. Αυτό διασφαλίζει ότι οι πληροφορίες βρίσκονται στο σωστό μέρος, τη σωστή στιγμή. Η ροή συμβάντων μπορεί να εφαρμοστεί σε πολλές περιπτώσεις χρήσης που χρειάζονται ζωντανές ροές δεδομένων. Αυτά περιλαμβάνουν χρηματοπιστωτικά ιδρύματα, υγειονομική περίθαλψη, κυβέρνηση, βιομηχανία μεταφορών και εταιρείες λογισμικού υπολογιστών.
5. AsyncAPI
AsyncAPI είναι μια πρωτοβουλία ανοιχτού κώδικα που βοηθά στη δημιουργία και τη διατήρηση αρχιτεκτονικών που βασίζονται σε εκδηλώσεις. Οι προδιαγραφές του έχουν πολλά κοινά σημεία με τις προδιαγραφές OpenAPI. Το AsyncAPI είναι ουσιαστικά μια προσαρμογή και βελτίωση των προδιαγραφών OpenAPI, με μερικές διαφορές.
Η αρχιτεκτονική AsyncAPI συνδυάζει ένα μείγμα REST API και API που βασίζονται σε συμβάντα. Τα σχήματά του για το χειρισμό αιτημάτων και απαντήσεων είναι παρόμοια με αυτή των API συμβάντων. Το AsyncAPI παρέχει προδιαγραφές για την περιγραφή και την τεκμηρίωση ασύγχρονων εφαρμογών σε αναγνώσιμο από μηχανή μορφή. Παρέχει επίσης εργαλεία όπως γεννήτριες κώδικα για να διευκολύνει τους χρήστες να τα εφαρμόσουν.
Το AsyncAPI βελτιώνει την τρέχουσα κατάσταση της αρχιτεκτονικής βάσει συμβάντων (EDA). Ο στόχος είναι να διευκολυνθεί η εργασία με τα EDA όπως συμβαίνει με τα REST API. Η πρωτοβουλία AsyncAPI παρέχει τεκμηρίωση και κώδικα, που υποστηρίζουν τη διαχείριση συμβάντων. Η πλειονότητα των διαδικασιών που χρησιμοποιούνται στα API REST ισχύουν για API που βασίζονται σε συμβάντα/ασύγχρονα.
Η χρήση της προδιαγραφής AsyncAPI για την τεκμηρίωση συστημάτων που βασίζονται σε συμβάντα είναι ζωτικής σημασίας. Διέπει και διατηρεί τη συνέπεια και την αποτελεσματικότητα μεταξύ των ομάδων που εργάζονται σε έργα που βασίζονται σε εκδηλώσεις.
6. Κλήση απομακρυσμένης διαδικασίας (RPC)
Το RPC είναι ένα πρωτόκολλο επικοινωνίας λογισμικού που επιτρέπει την επικοινωνία μεταξύ διαφορετικών προγραμμάτων σε ένα δίκτυο. Για παράδειγμα, ένα πρόγραμμα μπορεί να ζητήσει πληροφορίες από άλλον υπολογιστή του δικτύου. Δεν χρειάζεται να συμμορφώνεται με τα πρωτόκολλα δικτύου. Μπορείτε να χρησιμοποιήσετε το RPC για να καλέσετε διεργασίες σε απομακρυσμένα συστήματα όπως και στο τοπικό σύστημα.
Το RPC λειτουργεί στο μοντέλο πελάτη-διακομιστή. Το πρόγραμμα πελάτη ζητά και το πρόγραμμα διακομιστή ανταποκρίνεται με μια υπηρεσία. Τα RPC λειτουργούν σε συγχρονισμό. Όταν ένα πρόγραμμα στέλνει ένα αίτημα, παραμένει σε αναστολή μέχρι να λάβει απάντηση από τον διακομιστή.
Τα RPC είναι τα καλύτερα για κατανεμημένα συστήματα. Είναι τα καλύτερα για συστήματα που βασίζονται σε εντολές και έχουν ελαφρύ ωφέλιμο φορτίο που αυξάνει την απόδοση.
Πώς να επιλέξετε τη σωστή αρχιτεκτονική API
Η σωστή αρχιτεκτονική API εξαρτάται από την περίπτωση χρήσης σας. Η αρχιτεκτονική καθορίζει τη μεθοδολογία για την ανάπτυξη του API και τον τρόπο εκτέλεσης του. Ο αρχιτεκτονικός σχεδιασμός του API καθορίζει τα στοιχεία και τις αλληλεπιδράσεις του.
Λάβετε αρχιτεκτονικές αποφάσεις πριν σχεδιάσετε και αναπτύξετε το API. Προσδιορίστε τις τεχνικές απαιτήσεις του API, το επίπεδο, τη διαχείριση του κύκλου ζωής και την ασφάλεια. Τα σχέδια αρχιτεκτονικής API περιέχουν δομικά επίπεδα. Τα επίπεδα καθοδηγούν την ανάπτυξη και διασφαλίζουν ότι το API που δημιουργήθηκε εξυπηρετεί τον επιδιωκόμενο σκοπό του.
