Αποστολή αιτήματος στο πρώτο σας API στις Συντομεύσεις
Για να στείλετε αίτημα στο πρώτο σας API, πρέπει να δημιουργήσετε τη διεύθυνση URL που δείχνει στο «τελικό σημείο» API με το οποίο θέλετε να επικοινωνήσετε και μετά να μεταβιβάσετε αυτή τη διεύθυνση URL στην ενέργεια «Λήψη περιεχομένων URL». Όταν εκτελείται η συντόμευση, αυτή η ενέργεια στέλνει το αίτημα API.
Δόμηση του αιτήματος API
Το τελικό σημείο «Πρόγνωση» του Dark Sky απαιτεί τη μορφοποίηση ενός αιτήματος URL ως εξής:
https://api.darksky.net/forecast/[ΤΟ_ΜΥΣΤΙΚΟ_ΚΛΕΙΔΙ_ΣΑΣ]/[LAT],[LONG]
Το κείμενο στις αγκύλες συμπληρώνεται με ένα κλειδί API και την τοποθεσία για την οποία θέλετε δεδομένα πρόγνωσης.
Στην εφαρμογή «Συντομεύσεις», τοποθετήστε το κλειδί API από το Dark Sky στην πρώτη ενέργεια «Κείμενο», η οποία μεταβιβάζεται στην ενέργεια URL ως μεταβλητή. Οι παράμετροι
LATκαιLONGέχουν ήδη τις τιμές37.8267και-122.4233, που είναι οι συντεταγμένες για το νησί Αλκατράζ στο Σαν Φρανσίσκο. (Μπορείτε να αλλάξετε αυτές τις τιμές σε μια διαφορετική τοποθεσία.)Δοκιμάστε να χρησιμοποιήσετε την ενέργεια «Λήψη τρέχουσας τοποθεσίας» και να την τοποθετήσετε ως μαγική μεταβλητή με το γεωγραφικό πλάτος (Latitude) και το γεωγραφικό μήκος (Longitude) στην ενέργεια URL, για να λαμβάνετε δεδομένα καιρού της περιοχής σας κάθε φορά που εκτελείτε τη συντόμευση.
Εκτέλεση του αιτήματος API με την ενέργεια «Λήψη περιεχομένων URL»
Στον επεξεργαστή συντομεύσεων της εφαρμογής «Συντομεύσεις», ορίστε την ενέργεια «Λήψη περιεχομένων URL» σε «Προηγμένα».
Θα γίνουν διαθέσιμες οι ακόλουθες επιλογές για τους τύπους αιτημάτων API που μπορείτε να στείλετε:
Το
GETεπιτρέπει την ανάκτηση δεδομένων.Το
POSTεπιτρέπει τη δημιουργία νέων δεδομένων.Το
PUTεπιτρέπει την ενημέρωση δεδομένων μέσω της αντικατάστασής τους.Το
PATCHεπιτρέπει την ενημέρωση δεδομένων μέσω της τροποποίησής τους.Με το
DELETEμπορείτε να αφαιρέσετε ένα αντικείμενο που καθορίζεται στο αίτημα URL.
Για αυτό το παράδειγμα, χρησιμοποιήστε ένα αίτημα
GETγια να ανακτήσετε δεδομένα από το API Dark Sky.Τώρα που η ενέργεια URL έχει το αίτημά σας και η ενέργεια «Λήψη περιεχομένων URL» έχει διαμορφωθεί για τη λήψη (
GET) δεδομένων, είστε έτοιμοι να πραγματοποιήσετε το αίτημα API.Σημείωση: Αν η ενέργεια «Λήψη περιεχομένων URL» αλλάξει σε
POST,PUTήPATCH, θα προστεθεί μια νέα παράμετρος «Κύριο τμήμα αιτήματος». Το «Κύριο τμήμα αιτήματος» σας επιτρέπει να στείλετε δεδομένα JSON, μια Φόρμα ή ένα Αρχείο στο API ως μέρος του αιτήματός σας. Αυτό σας δίνει τη δυνατότητα να εισαγάγετε νέα δεδομένα χειροκίνητα ή χρησιμοποιώντας μεταβλητές, ώστε να μπορείτε να στείλετε τα δεδομένα στο API για τη δημιουργία, την αντικατάσταση ή την τροποποίηση μιας καταχώρισης.Αγγίξτε
για να δοκιμάσετε τη συντόμευση (με την ενέργεια «Άμεση προβολή» στη συντόμευση μπορείτε να δείτε μια προεπισκόπηση των δεδομένων που επιστρέφει το API).
Με μια πρώτη ματιά, το API φαίνεται να επιστρέφει ακατάστατο κείμενο. Αυτά τα δεδομένα καιρού κωδικοποιούνται σε μορφή JSON, από τα αρχικά των λέξεων JavaScript Object Notation (Σημειογραφία αντικειμένων JavaScript).
Για να μάθετε σχετικά με την εργασία με JSON και για να συνεχίσετε με το παράδειγμα API Dark Sky, δείτε την ενότητα Εισαγωγή στη χρήση JSON στις Συντομεύσεις.