JSON σε συμβολοσειρά ερωτήματος
Δημιουργήστε μια συμβολοσειρά ερωτήματος URL από ένα αντικείμενο JSON. Κάθε τιμή κωδικοποιείται σε μορφή percent, τα εμφωλευμένα αντικείμενα χρησιμοποιούν σημειογραφία αγκυλών όπως filter[status]=open και οι πίνακες γράφονται ως επαναλαμβανόμενα κλειδιά, με αγκύλες, με δείκτες ή ως λίστες τιμών χωρισμένων με κόμμα. Επιλέξτε %20 ή + για τα κενά, ανάλογα με τον διακομιστή που διαβάζει το URL.
Συχνές ερωτήσεις
Ποιες μορφές πινάκων είναι διαθέσιμες;
Η μορφή «επανάληψη» γράφει ids=1&ids=2, η μορφή «αγκύλες» γράφει ids[]=1&ids[]=2, η μορφή «δείκτες» γράφει ids[0]=1&ids[1]=2 και η μορφή «κόμμα» γράφει ids=1,2. Η επανάληψη είναι η μορφή που στέλνουν τα URLSearchParams και οι περισσότεροι πελάτες HTTP· τα PHP και Rails αναμένουν αγκύλες ή δείκτες.
Πώς γράφονται τα εμφωλευμένα αντικείμενα;
Με σημειογραφία αγκυλών: {"filter": {"status": "open"}} γίνεται filter[status]=open. Τα βαθύτερα αντικείμενα προσθέτουν περισσότερες αγκύλες, όπως a[b][c]=1.
Τα κενά πρέπει να είναι %20 ή +;
Και τα δύο δηλώνουν κενό σε μια συμβολοσειρά ερωτήματος. Το %20 είναι σωστό σε οποιοδήποτε μέρος ενός URL, ενώ το + χρησιμοποιείται στις φόρμες HTML. Οι περισσότεροι διακομιστές δέχονται και τα δύο, οπότε επιλέξτε αυτό που χρησιμοποιεί ο διακομιστής σας ή η τεκμηρίωση του API.
Γιατί οι αγκύλες κωδικοποιούνται ως %5B και %5D;
Οι αγκύλες είναι δεσμευμένοι χαρακτήρες στις διευθύνσεις URL, επομένως κωδικοποιούνται ως ποσοστά από προεπιλογή, όπως κάνουν η http_build_query του PHP και η βιβλιοθήκη qs. Ενεργοποιήστε τις ευανάγνωστες αγκύλες για να παραμείνουν ως [ και ], τις οποίες δέχονται επίσης οι περισσότεροι διακομιστές.
Ποιοι χαρακτήρες παραμένουν χωρίς κωδικοποίηση;
Τα γράμματα, τα ψηφία και οι χαρακτήρες - _ . ! ~ * ' ( ) παραμένουν ως έχουν. Όλα τα υπόλοιπα, συμπεριλαμβανομένων των &, =, # και των μη ASCII γραμμάτων, κωδικοποιούνται ως ποσοστά με UTF-8.
Πώς γράφονται οι τιμές null και οι λογικές τιμές;
Οι τιμές true, false και οι αριθμοί γράφονται ως κείμενο, για παράδειγμα active=true. Το null γίνεται κενή τιμή, όπως στο note=.