I moderni endpoint REST, GraphQL-over-GET e webhook inseriscono regolarmente array multivalore, oggetti filtro annidati, cursori Base64 e frasi di ricerca codificate URL in un'unica query string o in un body di richiesta application/x-www-form-urlencoded. Ispezionare o modificare questi payload come una stringa grezza piatta espone al rischio di sequenze di escape %26 corrotte e parentesi non bilanciate.
Consideriamo una query di ricerca API che combina spazi codificati con +, chiavi ripetute, filtri con parentesi annidate, un cursore di paginazione Base64 con padding = codificato in percentuale e un parametro flag senza valore:
?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run
L'analisi di questa stringa produce una rappresentazione JSON fortemente strutturata e immediatamente leggibile:
{
"q": "distributed tracing",
"tag": [
"otel",
"grpc"
],
"filter": {
"status": "open",
"priority": "high"
},
"cursor": "eyJpZCI6NDIwfQ==",
"dry_run": ""
}
Perché la Divisione dei Delimitatori Deve Precedere la Decodifica Percentuale
Nota come cursor=eyJpZCI6NDIwfQ%3D%3D venga decodificato correttamente in "eyJpZCI6NDIwfQ==". Il parser divide prima la stringa grezza su &, separa ogni coppia sul primo carattere letterale = e solo successivamente decodifica le sequenze + e %XX. Se uno script ingenuo eseguisse decodeURIComponent() sull'intera query string prima di dividere su & e =, qualsiasi valore di parametro contenente una e commerciale sottoposta a escape (R%26D -> R&D) si spezzerebbe in due parametri errati.
Poiché la vista JSON e la tabella chiave-valore rimangono sincronizzate in modo bidirezionale, puoi anche incollare un oggetto filtro JSON dal codice della tua applicazione e serializzare immediatamente una query string con escape corretto pronta per le richieste HTTP.