Τα σύγχρονα endpoints REST, GraphQL-over-GET και webhooks συσκευάζουν τακτικά πίνακες πολλαπλών τιμών, ένθετα αντικείμενα φίλτρων, δρομείς Base64 και κωδικοποιημένες φράσεις αναζήτησης URL σε ένα ενιαίο query string ή σώμα αιτήματος application/x-www-form-urlencoded. Η επιθεώρηση ή η επεξεργασία αυτών των δεδομένων ως απλής ακατέργαστης συμβολοσειράς προκαλεί κατεστραμμένες ακολουθίες διαφυγής %26 και αταίριαστες αγκύλες.
Εξετάστε ένα ερώτημα αναζήτησης API που συνδυάζει κενά κωδικοποιημένα με +, επαναλαμβανόμενα κλειδιά, ένθετα φίλτρα αγκυλών, έναν δρομέα σελιδοποίησης Base64 με ποσοστιαία κωδικοποιημένο συμπλήρωμα = και μια απλή παράμετρο σημαίας (flag):
?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run
Η ανάλυση αυτής της συμβολοσειράς παράγει μια άμεσα ευανάγνωστη, αυστηρά δομημένη αναπαράσταση JSON:
{
"q": "distributed tracing",
"tag": [
"otel",
"grpc"
],
"filter": {
"status": "open",
"priority": "high"
},
"cursor": "eyJpZCI6NDIwfQ==",
"dry_run": ""
}
Γιατί ο Διαχωρισμός Οριοθετών Πρέπει να Προηγείται της Ποσοστιαίας Αποκωδικοποίησης
Παρατηρήστε πώς το cursor=eyJpZCI6NDIwfQ%3D%3D αποκωδικοποιείται καθαρά σε "eyJpZCI6NDIwfQ==". Ο αναλυτής χωρίζει πρώτα την ακατέργαστη συμβολοσειρά στο &, χωρίζει κάθε ζεύγος στο πρώτο κυριολεκτικό =, και μόνο τότε αποκωδικοποιεί τις ακολουθίες + και %XX. Εάν ένα απλοϊκό σενάριο εκτελούσε decodeURIComponent() σε ολόκληρο το query string πριν από τον διαχωρισμό στα & και =, οποιαδήποτε τιμή παραμέτρου που περιέχει κωδικοποιημένο σύμβολο ampersand (R%26D -> R&D) θα έσπαγε σε δύο εσφαλμένες παραμέτρους.
Επειδή η προβολή JSON και ο πίνακας κλειδιού-τιμής παραμένουν αμφίδρομα συγχρονισμένοι, μπορείτε επίσης να επικολλήσετε ένα αντικείμενο φίλτρου JSON από τον κώδικα της εφαρμογής σας και να σειριοποιήσετε αμέσως ένα σωστά κωδικοποιημένο query string έτοιμο για αιτήματα HTTP.