Τι σημαίνει το API; Ένας ορισμός του ακρωνύματος κωδικοποίησης στα απλά αγγλικά.

Όχι, το API δεν σημαίνει Apple Pie Inside. ?? Το API σημαίνει διεπαφή προγραμματισμού εφαρμογών. Τα API επιτρέπουν σε δύο εφαρμογές να αλληλεπιδρούν (ή να αλληλεπιδρούν) μεταξύ τους.

Ένα API ένα σύνολο οδηγιών και λειτουργιών προγραμματισμού που χρησιμοποιούνται για πρόσβαση σε έναν ιστότοπο ή σε μια εφαρμογή λογισμικού που βασίζεται στον Ιστό. Ένα API επιτρέπει σε άλλους προγραμματιστές να χρησιμοποιούν τα δεδομένα και τη λειτουργικότητα της εφαρμογής σας. Επιτρέπει στο προϊόν σας να αλληλεπιδρά με άλλα προϊόντα.

Τα API χρησιμοποιήθηκαν για πρώτη φορά στην ανάπτυξη λογισμικού και υλικού στη δεκαετία του 1980. Αλλά τώρα, όταν οι άνθρωποι μιλούν για API, συνήθως αναφέρονται σε API ιστού ή πιο συγκεκριμένα σε RESTful API. Έχει γίνει κοινή πρακτική η χρήση RESTful API κατά την ανάπτυξη εφαρμογών που βασίζονται στον ιστό.

Ένα διαδικτυακό API είναι βασικά ένα πρόγραμμα με το οποίο αλληλεπιδράτε πλήρως μέσω διευθύνσεων URL. Κανονικά όταν στέλνετε ένα αίτημα σε μια διεύθυνση URL με το πρόγραμμα περιήγησής σας, ένας διακομιστής αποστέλλει μια απάντηση που εμφανίζεται για να δείτε. Τα πράγματα είναι διαφορετικά όταν στέλνετε ένα αίτημα σε μια διεύθυνση URL ενός API. Ο διακομιστής στέλνει πίσω κάτι που προορίζεται να είναι χρήσιμο μόνο στον υπολογιστή. Ένα API επιστρέφει δεδομένα που μπορούν να χρησιμοποιηθούν σε διαφορετικό ιστότοπο ή πρόγραμμα.

Σε τι χρησιμοποιούνται τα API;

Τα API δεν προορίζονται να χρησιμοποιηθούν από έναν τελικό χρήστη. Χρησιμοποιούνται για λογισμικό για αλληλεπίδραση με άλλο λογισμικό. Για παράδειγμα, ένας ιστότοπος μπορεί να πραγματοποιήσει μια κλήση στο Open Weather API για να εμφανίσει πληροφορίες καιρού στον ιστότοπο.

Οι APIs χρησιμοποιούνται μερικές φορές εσωτερικά σε μία εταιρεία. Μπορούν να χρησιμοποιηθούν για τη δημιουργία εσωτερικών ιστότοπων και συστημάτων που αλληλεπιδρούν εύκολα μεταξύ τους.

Πώς λειτουργεί ένα API;

Ένα API παρέχει σε άλλους πρόσβαση σε μεγάλο αριθμό οργανωμένων δεδομένων. Ο φύλακας αυτών των δεδομένων δίνει στον προγραμματιστή άδεια (με τη μορφή κλειδιού API ) να ζητήσει πληροφορίες από έναν διακομιστή. Εάν το αίτημα είναι επιτυχές, ο διακομιστής αποκρίνεται με ένα μήνυμα, συνήθως σε μορφή JSON ή XML.

Συνήθως θα υπάρχει τεκμηρίωση για ένα API που θέλετε να χρησιμοποιήσετε που ονομάζεται προδιαγραφή API. Αυτό εξηγεί τα στοιχεία ελέγχου και τον τρόπο χρήσης του API.

Ακολουθεί ένα παράδειγμα της προδιαγραφής API για το OpenWeather API που σας επιτρέπει να λάβετε τον τρέχοντα καιρό σε μια συγκεκριμένη τοποθεσία: //openweathermap.org/current

Οι προδιαγραφές API περιέχουν μια λίστα διευθύνσεων URL που μπορείτε να χρησιμοποιήσετε για την ανάκτηση δεδομένων. Η χρήση ενός από τα URL ονομάζεται αίτημα API ή κλήση API . Συχνά η προδιαγραφή θα εμφανίζει παραμέτρους και την απόκριση για κάθε διεύθυνση URL που αποτελεί μέρος του API.

Παράμετροι

Οι παράμετροι είναι αυτό που προσθέτετε στο τέλος μιας διεύθυνσης URL για να καθορίσετε ποιες πληροφορίες θέλετε να επιστρέψει το API. Οι παράμετροι είναι βασικά μεταβλητές που μεταβιβάζετε στο API.

Η διεύθυνση URL για τη λήψη πληροφοριών σχετικά με τον καιρό από το OpenWeather API είναι:

api.openweathermap.org/data/2.5/weather.

Ωστόσο, πρέπει να προσθέσετε μια πόλη ως παράμετρο για να καθορίσετε σε ποια τοποθεσία θα επιστρέψετε τα δεδομένα καιρού. Ακολουθεί η διεύθυνση URL με την παράμετρο πόλης:

api.openweathermap.org/data/2.5/weather?q=London

Μερικές φορές απαιτούνται παράμετροι για να λάβετε απάντηση. Μερικές φορές οι παράμετροι είναι προαιρετικές. Στο OpenWeather API, απαιτείται η παροχή μιας τοποθεσίας, αλλά υπάρχουν και άλλοι τρόποι προσδιορισμού της τοποθεσίας εκτός από το όνομα της πόλης. Όλοι οι τρόποι δίνονται στην προδιαγραφή API.

Οι παράμετροι μπορούν επίσης να καθορίσουν πράγματα όπως:

  • Πώς πρέπει να ταξινομηθούν τα αποτελέσματα;
  • Πόσα αποτελέσματα πρέπει να επιστραφούν;
  • Σε ποια μορφή πρέπει να είναι τα αποτελέσματα;
  • Για ποιο εύρος ημερομηνιών θέλετε τα αποτελέσματα;

Η απάντηση

Όταν στέλνετε ένα αίτημα σε ένα API, θα λάβετε μια απάντηση. Θα λάβετε είτε τα δεδομένα που ζητήσατε είτε έναν λόγο για τον οποίο το αίτημα απέτυχε.

Παρακάτω είναι ένα παράδειγμα της απάντηση που παίρνετε όταν στέλνετε το ακόλουθο αίτημα: api.openweathermap.org/data/2.5/weather?q=London. Είναι μια απάντηση JSON.

{ "coord": { "lon": -0.13, "lat": 51.51 }, "weather": [ { "id": 300, "main": "Drizzle", "description": "light intensity drizzle", "icon": "09d" } ], "base": "stations", "main": { "temp": 280.32, "pressure": 1012, "humidity": 81, "temp_min": 279.15, "temp_max": 281.15 }, "visibility": 10000, "wind": { "speed": 4.1, "deg": 80 }, "clouds": { "all": 90 }, "dt": 1485789600, "sys": { "type": 1, "id": 5091, "message": 0.0103, "country": "GB", "sunrise": 1485762037, "sunset": 1485794875 }, "id": 2643743, "name": "London", "cod": 200 }

Μια απόκριση API ενδέχεται να μην έχει μορφοποίηση όπως αυτό το παράδειγμα. Όλο το κείμενο είναι συχνά σε μία γραμμή. Δεδομένου ότι προορίζεται κυρίως για ανάγνωση από υπολογιστή και όχι από άτομο, η μορφοποίηση δεν έχει σημασία.

Κλειδιά API

Εάν δοκιμάσετε μόνοι σας την παραπάνω διεύθυνση URL, δεν θα λάβετε την παραπάνω απάντηση. Πιθανότατα θα μοιάζει περισσότερο:

{ "cod": 401, "message": "Invalid API key. Please see //openweathermap.org/faq#error401 for more info." }

Τα περισσότερα API απαιτούν κάποιο έλεγχο ταυτότητας προτού επιστρέψουν δεδομένα. Συνήθως έχει τη μορφή κλειδιού API . Αυτά τα κλειδιά είναι σαν κωδικός πρόσβασης. Πρόκειται για μια μεγάλη σειρά γραμμάτων και αριθμών που πρέπει να στείλετε με το αίτημά σας API, ώστε ο διακομιστής να γνωρίζει ότι επιτρέπεται η πρόσβαση στις πληροφορίες.

Για το OpenWeather API και με πολλά άλλα API, μπορείτε να λάβετε ένα κλειδί API δωρεάν μετά τη δημιουργία λογαριασμού. Πολλές εταιρείες χρησιμοποιούν κλειδιά API σε δωρεάν API για να βεβαιωθούν ότι οι χρήστες δεν κάνουν πολλά αιτήματα σε μια μέρα. Θα μπορούσε πραγματικά να βλάψει έναν διακομιστή εάν ένα άτομο έκανε χιλιάδες αιτήματα κάθε λεπτό.

Ορισμένα API είναι δημόσια χωρίς κλειδί API. Ακολουθεί ένα API που σας επιτρέπει να βρείτε λέξεις με λέξεις. Κάντε κλικ στον σύνδεσμο και, στη συνέχεια, δοκιμάστε να αλλάξετε την τελική λέξη στη διεύθυνση URL για να αναζητήσετε διαφορετικές λέξεις.

//api.datamuse.com/words?rel_rhy=camp

Θέλετε να μάθετε περισσότερα;

Αν θέλετε να μάθετε περισσότερα σχετικά με τη χρήση API, ρίξτε μια ματιά στο παρακάτω βίντεο στο κανάλι YouTube freeCodeCamp.org.