Κλήση μιας μεθόδου
POST ή GET, σώμα έναντι συμβολοσειράς ερωτήματος, και τι περιμένει ο επικυρωτής πεδίων.
Το όνομα μιας μεθόδου είναι μέρος της διεύθυνσης URL. Κάθε άλλη είσοδος, συμπεριλαμβανομένου ενός αναγνωριστικού, είναι παράμετρος: πεδίο σώματος JSON
στο POST, παράμετρος συμβολοσειράς ερωτήματος στο GET. Και οι δύο μορφές φτάνουν στην ίδια μέθοδο και επιστρέφουν
τον ίδιο φάκελο απάντησης.
POST: σώμα JSON
Η κανονική μορφή για οτιδήποτε έχει περισσότερες από λίγες παραμέτρους, ή έχει ένθετο αντικείμενο ή πίνακα.
GET: συμβολοσειρά ερωτήματος
Βολική για έναν γρήγορο έλεγχο από τη γραμμή διευθύνσεων του προγράμματος περιήγησης ή μια εντολή curl μίας γραμμής. Ο διακομιστής αναλύει τη
συμβολοσειρά ερωτήματος στο ίδιο σώμα που βλέπει ο χειριστής της μεθόδου, οπότε οι κανόνες παρακάτω μετράνε περισσότερο εδώ από ό,τι
στο POST.
Ο δηλωμένος τύπος ενός πεδίου καθορίζει πώς διαβάζεται η τιμή του στη συμβολοσειρά ερωτήματος:
- string: χρησιμοποιείται ως έχει.
- number: περνά από το
Number(...). - boolean: μόνο η κυριολεκτική συμβολοσειρά
trueδιαβάζεται ωςtrue. Οτιδήποτε άλλο περάσετε για ένα πεδίο boolean στοGET, συμπεριλαμβανομένου τουfalse, μετατρέπεται σε αληθές1. Αν ένα boolean έχει σημασία, στείλτε το μεPOSTμε πραγματικό JSONtrue/false, ή απλώς παραλείψτε την παράμετρο ερωτήματος για να μείνει στην προεπιλογή της μεθόδου. - object / array: η τιμή περνά από το
JSON.parse(...), οπότε μια ένθετη τιμή στοGETπρέπει να είναι μία παράμετρος ερωτήματος που κρατά μια συμβολοσειρά JSON (filters=%7B%22status%22%3A%22open%22%7D), όχι ένθεση ερωτήματος τύπου αγκυλών.
Υποχρεωτικά πεδία και σφάλματα τύπου
Τα πεδία μιας μεθόδου φέρουν το καθένα μια σημαία mandatory και έναν type. Αν λείπει ένα υποχρεωτικό πεδίο, ή
στείλετε λάθος τύπο στο POST (όπου τίποτα δεν μετατρέπεται αυτόματα), παίρνετε πίσω ένα -1 πριν καν εκτελεστεί
η ίδια η μέθοδος:
Η διαδραστική αναφορά API απαριθμεί τα πεδία κάθε μεθόδου με τους τύπους και τις σημαίες υποχρεωτικότητάς τους, και σας επιτρέπει να εκτελέσετε μια κλήση από το πρόγραμμα περιήγησης για να δείτε το ακριβές αίτημα που δημιούργησε.