Οι διεπαφές προγραμματισμού εφαρμογών (API) διαδραματίζουν ουσιαστικό ρόλο στην ανάπτυξη λογισμικού. Εάν σκοπεύετε να αναπτύξετε μια διαδικτυακή εφαρμογή ή ιστότοπο, θα χρειαστεί είτε να δημιουργήσετε ένα API, είτε να χρησιμοποιήσετε ένα υπάρχον ή και τα δύο.
Ένα API μεταφέρει ένα αίτημα από μια εφαρμογή λογισμικού σε μια άλλη και στη συνέχεια επιστρέφει στο λογισμικό εκκίνησης με μια σχετική απάντηση. Επομένως, εάν το API σας είναι ελαττωματικό, τότε η εφαρμογή σας θα αντιμετωπίσει προβλήματα. Η πλατφόρμα Postman σάς βοηθά να διατηρήσετε λειτουργικά τα API σας, παρέχοντας δοκιμές API μεταξύ άλλων χρήσιμων λειτουργιών.
Τι είναι ο Ταχυδρόμος;
Ο Ταχυδρόμος είναι μια πλατφόρμα που σας βοηθά να εργασία με API. Είναι ένα αποθετήριο API, το οποίο σας επιτρέπει να αποθηκεύετε, να οργανώνετε και να χρησιμοποιείτε τα API σας. Το αποθετήριο του Postman βασίζεται σε σύννεφο και ελεγχόμενη από έκδοση, επομένως είναι η ιδανική πλατφόρμα για συλλογική ανάπτυξη API, καθώς και ανάπτυξη API σε πολλά συσκευές.
Ο Postman σάς επιτρέπει να διαχειρίζεστε κάθε πτυχή της ροής εργασιών ανάπτυξης API. Αυτή η πλατφόρμα παρέχει όλα όσα χρειάζεστε για να δοκιμάσετε μια ολοκληρωμένη CRUD API. Μερικά από τα δημοφιλή χαρακτηριστικά του Postman περιλαμβάνουν:
- Προδιαγραφές
- Τεκμηρίωση
- Συνταγές ροής εργασιών
- Δοκιμές
- Μετρήσεις
Εγκατάσταση Postman στη συσκευή σας
Μπορείτε να κάνετε λήψη Ταχυδρόμος από τον επίσημο ιστότοπο της σε υπολογιστή Windows, Apple ή Linux. Επιλέγοντας τον τύπο του μηχανήματος ξεκινά η αυτόματη λήψη ενός εκτελέσιμου αρχείου. Αυτό θα εγκαταστήσει την πλατφόρμα Postman με μερικά εύκολα βήματα.
Πώς να δημιουργήσετε αιτήματα χρησιμοποιώντας τον Postman
Η πιο πρόσφατη έκδοση της πλατφόρμας Postman (v9.28.1) ξεκινά με την ακόλουθη διεπαφή χρήστη:
Για να στείλετε ένα αίτημα σε ένα υπάρχον API, κάντε κλικ στο νέος κουμπί στην επάνω αριστερή γωνία της διεπαφής Postman. Αυτό θα σας οδηγήσει στο ακόλουθο αναδυόμενο παράθυρο:
Στην επάνω αριστερή γωνία του αναδυόμενου παραθύρου υπάρχει η επιλογή δημιουργίας α βασικό αίτημα HTTP. Επιλέγοντας αυτήν την επιλογή μεταφέρεστε στην ακόλουθη διεπαφή:
Υπάρχουν πολλά σημαντικά πεδία στη διεπαφή αιτημάτων. Το πρώτο πεδίο στο οποίο πρέπει να προσέξετε είναι το πεδίο της μεθόδου αιτήματος (ή του ρήματος). Η προεπιλεγμένη μέθοδος αιτήματος είναι ΠΑΙΡΝΩ, αλλά υπάρχουν πάνω από 10 διαφορετικές μέθοδοι για να διαλέξετε.
Οι πέντε μέθοδοι που θα χρησιμοποιείτε τακτικά περιλαμβάνουν:
- GET: λαμβάνει δεδομένα από μια βάση δεδομένων.
- POST: προσθέτει νέα δεδομένα σε μια βάση δεδομένων.
- PUT: ενημερώνει ένα ολόκληρο πεδίο δεδομένων σε μια βάση δεδομένων.
- PATCH: ενημερώνει συγκεκριμένες πτυχές ενός πεδίου δεδομένων σε μια βάση δεδομένων.
- ΔΙΑΓΡΑΦΗ: διαγράφει δεδομένα από μια βάση δεδομένων.
Το πεδίο URL βρίσκεται ακριβώς δίπλα στο πεδίο της μεθόδου αιτήματος. Για να δοκιμάσετε ένα API, απλώς επιλέγετε τη μέθοδο αιτήματος και παρέχετε την κατάλληλη διεύθυνση URL.
Δοκιμή ενός δημόσιου API στο Postman
Μπορείτε να χρησιμοποιήσετε οποιοδήποτε δημόσιο API σε αυτήν την ενότητα. Το ακόλουθο παράδειγμα χρησιμοποιεί ένα API ειδήσεων που ονομάζεται Newsdata.io. Αυτό το API έχει πολλές επιλογές ερωτημάτων που επιστρέφουν ειδήσεις σε όλο τον κόσμο. Το τελικό σημείο που βασίζεται σε χώρα έχει αυτή τη δομή:
https://newsdata.io/api/1/news? apikey=YOUR_API_KEY&country=εμάς
Θα χρειαστεί να αντικαταστήσετε το YOUR_API_Key τιμή στη διεύθυνση URL με το κλειδί API που θα λάβετε αφού εγγραφείτε στο Newsdata.io. Η εισαγωγή της ενημερωμένης διεύθυνσης URL στο Postman επιστρέφει παρόμοια έξοδο με την παρακάτω.
{
"κατάσταση": "επιτυχία",
"συνολικά Αποτελέσματα": 10173,
"Αποτελέσματα": [
{
"τίτλος": "Η Apple θα μπορούσε να είναι η πρώτη που θα χρησιμοποιήσει το TSMC's διαδικασία τσιπ 3nm για M2 Pro",
"Σύνδεσμος": "https://appleinsider.com/articles/22/08/18/apple-could-be-the-first-to-use-tsmcs-3nm-chip-process-for-m2-pro? utm_medium=rss",
"λέξεις-κλειδιά": μηδενικό,
"δημιουργός": [
"[email protected] (Mike Peterson)"
],
"video_url": μηδενικό,
"περιγραφή": "μήλο'Τα MacBook Pro του 2022 μπορούν να συσκευάσουν νέα chipset M2 Pro και M2 Max κατασκευασμένα με TSMC'της τελευταίας διαδικασίας κατασκευής 3nm, σύμφωνα με μια νέα έκθεση. M2TSMC, ο κόσμος'Ο μεγαλύτερος κατασκευαστής συμβάσεων ημιαγωγών, αναπτύσσει σταθερά τις διαδικασίες παραγωγής 3 nm. Σύμφωνα με τους Commercial Times, η Apple θα μπορούσε να είναι ο πρώτος πελάτης που θα πάρει στα χέρια της αυτά τα τσιπ. Διαβάστε περισσότερα...",
"περιεχόμενο": μηδενικό,
"pubDate": "2022-08-18 15:22:53",
"image_url": μηδενικό,
"πηγή_αναγνωριστικό": "appleinsider",
"Χώρα": [
"Ηνωμένες πολιτείες Αμερικής",
"Ηνωμένο Βασίλειο",
"Ινδία",
"Αυστραλία",
"Σιγκαπούρη",
"Καναδάς"
],
"κατηγορία": [
"τεχνολογία"
],
"Γλώσσα": "Αγγλικά"
},
],
"επόμενη σελίδα": 1
}
Ο Ταχυδρόμος θα επιστρέψει μια σειρά από ειδήσεις. Η παραπάνω έξοδος εμφανίζει μόνο ένα παράδειγμα αυτών των ειδήσεων.
Τώρα μπορείτε να δοκιμάσετε API με τον Postman
Ο Postman είναι μια δημοφιλής πλατφόρμα που μπορείτε να χρησιμοποιήσετε για να δοκιμάσετε τα API που θέλετε να χρησιμοποιήσετε στα έργα σας. Μπορείτε να διατηρήσετε ένα σύνολο πόρων και να χρησιμοποιήσετε μια σειρά μεθόδων αιτήματος.
Αφού δοκιμάσετε τα API σας, το λογικό επόμενο βήμα είναι να τα ενσωματώσετε στις εφαρμογές σας.