Codifica e decodifica URL

Perché un URL non può contenere semplicemente qualsiasi cosa

Un URL ha una grammatica. Il punto interrogativo apre la query, la e commerciale separa i parametri, il segno di uguale accoppia un nome con un valore, il cancelletto salta a un frammento — questi caratteri sono struttura, non contenuto. Incolla un valore che li contiene in forma grezza e l'URL cambia silenziosamente significato: cerca fish & chips senza codifica e tutto ciò che segue la e commerciale viene letto come un parametro completamente nuovo, così il povero server cerca solo fish. Il percent-encoding è la via di fuga — ogni byte scomodo viene scritto come un segno di percentuale più due cifre esadecimali, con %20 per uno spazio come esempio più celebre. Le lettere accentate e le emoji diventano ciascuna diversi di questi byte, motivo per cui il testo non inglese si trasforma in sequenze di percentuali sorprendentemente lunghe. È normale, non è corruzione.

Decodificare: leggere cosa dice davvero un link

La modalità di decodifica si dimostra utile sui link creati da altre persone. I link di newsletter e pubblicità avvolgono di routine la destinazione reale dentro un parametro url= di qualche tracker di clic — decodifica il tutto e la destinazione effettiva salta fuori in testo semplice, il che vale la pena fare prima di fidarti di un link sconosciuto. È anche il modo rapido per leggere cosa ha davvero inviato un modulo o cosa chiedeva realmente una chiamata API. Uno schema da riconoscere: se il testo decodificato contiene ancora sequenze come %2520, il valore era stato codificato due volte — decodifica ancora una volta e si risolve. La doppia codifica è altrettanto il classico bug nella direzione opposta, quindi quando costruisci link, codifica ogni valore esattamente una volta, all'ultimo momento prima di assemblare l'URL.

Costruire link a mano

L'uso più comune del lato codifica è costruire link al di fuori di un linguaggio di programmazione — modelli di stampa unione, formule di fogli di calcolo, macro di supporto, test API rapidi. La ricetta affidabile: codifica ogni valore per conto suo, poi unisci i pezzi con i letterali ? & = da solo. È anche per questo che la modalità valore esegue l'escape persino delle barre — dentro un valore, una barra è solo un carattere. Questo strumento è gratuito senza limiti, come tutto il nostro set per sviluppatori. E un consiglio su cosa trovi dentro i link decodificati: un muro di lettere e cifre che termina con = di solito è Base64 — incollalo nel nostro decodificatore Base64 — e un valore lungo con due punti nel mezzo è molto probabilmente un token per il decodificatore JWT.

Due tipi di codifica — scegli quella giusta

Codifica un valore esegue l'escape di tutto ciò che ha un significato speciale in un URL (inclusi / ? & =) — usala per un singolo frammento di testo destinato a una query string, come un termine di ricerca. Codifica un URL completo esegue l'escape solo dei caratteri che non possono comparire affatto in un URL (come gli spazi) e lascia intatta la struttura dell'URL stesso. Usare quella sbagliata è la causa classica dei link rotti.