Αποστολή αιτήματος στο πρώτο σας API στις Συντομεύσεις στο Mac
Για να στείλετε αίτημα στο πρώτο σας API, πρέπει να δημιουργήσετε τη διεύθυνση URL που δείχνει στο «τελικό σημείο» API με το οποίο θέλετε να επικοινωνήσετε και μετά να μεταβιβάσετε αυτή τη διεύθυνση URL στην ενέργεια «Λήψη περιεχομένων URL». Όταν εκτελείται η συντόμευση, αυτή η ενέργεια στέλνει το αίτημα API.
Δόμηση του αιτήματος API
Το τελικό σημείο του Typicode απαιτεί τη μορφοποίηση ενός αιτήματος URL ως εξής:
https://jsonplaceholder.typicode.com/[RESOURCE]
Το κείμενο στις παρενθέσεις είναι ο πόρος τον οποίον θα θέλατε να προσπελάσετε. Το Typicode παρέχει πολλά διαφορετικά παραδείγματα για τον έλεγχο αιτημάτων. Αυτό το παράδειγμα θα χρησιμοποιεί το https://jsonplaceholder.typicode.com/users
για να αιτηθεί μια λίστα χρηστών.
Στην εφαρμογή «Συντομεύσεις» στο Mac, προσθέστε το αίτημα στο URL.
Το αίτημα για
users
θα επιστρέψει μια λίστα χρηστών.Μπορείτε να περιορίσετε την αναζήτησή σας προσδιορίζοντας έναν συγκεκριμένο χρήστη με το αναγνωριστικό:
https://jsonplaceholder.typicode.com/users/6
. Αυτό θα επιστρέψει τον χρήστη του οποίου το αναγνωριστικό είναι 6.Τα περισσότερα API επιτρέπουν τα ερωτήματα που χρησιμοποιούν την ακόλουθη μορφή:
https://jsonplaceholder.typicode.com/users?username=Bret
. Το «?» αρχίζει το ερώτημα που αναζητά στοιχεία χρησιμοποιώντας ζεύγη κλειδιών/τιμών. Σε αυτό το παράδειγμα, το ερώτημα?username=Bret
αναζητάει έναν χρήστη του οποίου το όνομα χρήστης είναι Bret.Ελέγξτε το πληροφοριακό υλικό του API για υποστηριζόμενες αναζητήσεις και ερωτήματα.
Εκτέλεση του αιτήματος API με την ενέργεια «Λήψη περιεχομένων URL»
Στην εφαρμογή «Συντομεύσεις» στο Mac, αγγίξτε «Εμφάνιση περισσότερων» στην ενέργεια «Λήψη περιεχομένων URL».
Θα γίνουν διαθέσιμες οι ακόλουθες επιλογές για τους τύπους αιτημάτων API που μπορείτε να στείλετε:
Το
GET
επιτρέπει την ανάκτηση δεδομένων.Το
POST
επιτρέπει τη δημιουργία νέων δεδομένων.Το
PUT
επιτρέπει την ενημέρωση δεδομένων μέσω της αντικατάστασής τους.Το
PATCH
επιτρέπει την ενημέρωση δεδομένων μέσω της τροποποίησής τους.Με το
DELETE
μπορείτε να αφαιρέσετε ένα αντικείμενο που καθορίζεται στο αίτημα URL.
Για αυτό το παράδειγμα, χρησιμοποιήστε ένα αίτημα
GET
για να ανακτήσετε δεδομένα από το API Typicode.Τώρα που η ενέργεια URL έχει το αίτημά σας και η ενέργεια «Λήψη περιεχομένων URL» έχει διαμορφωθεί για τη λήψη (
GET
) δεδομένων, είστε έτοιμοι να πραγματοποιήσετε το αίτημα API.Σημείωση: Αν η ενέργεια «Λήψη περιεχομένων URL» αλλάξει σε
POST
,PUT
ήPATCH
, θα προστεθεί μια νέα παράμετρος «Κύριο τμήμα αιτήματος». Το «Κύριο τμήμα αιτήματος» σας επιτρέπει να στείλετε δεδομένα JSON, μια Φόρμα ή ένα Αρχείο στο API ως μέρος του αιτήματός σας. Αυτό σας δίνει τη δυνατότητα να εισαγάγετε νέα δεδομένα χειροκίνητα ή χρησιμοποιώντας μεταβλητές, ώστε να μπορείτε να στείλετε τα δεδομένα στο API για τη δημιουργία, την αντικατάσταση ή την τροποποίηση μιας καταχώρισης.Για να ελέγξετε τη συντόμευση, κάντε κλικ στο .
Με μια πρώτη ματιά, το API φαίνεται να επιστρέφει ακατάστατο κείμενο. Αυτά τα δεδομένα κωδικοποιούνται σε μορφή JSON, από τα αρχικά των λέξεων JavaScript Object Notation (Σημειογραφία αντικειμένων JavaScript).
Για να μάθετε σχετικά με την εργασία με JSON και για να συνεχίσετε με το παράδειγμα API Typicode, δείτε την ενότητα Εισαγωγή στη χρήση JSON στις Συντομεύσεις στο Mac.