In questo articolo
Comprendere la struttura degli URL
Un URL (Uniform Resource Locator) e l'indirizzo di una risorsa sul web. Ogni URL segue un formato strutturato che indica al browser dove andare e come arrivarci. Comprendere questa struttura e essenziale per sviluppatori web, specialisti SEO e chiunque lavori con API web.
Un URL completo puo contenere fino a sette componenti distinti: schema (protocollo), nome utente e password (autenticazione), host (dominio), porta, percorso, stringa di query e frammento (hash). La maggior parte degli URL ne usa solo alcuni, ma conoscerli tutti aiuta a fare debug di URL complessi.
Come funziona il parsing degli URL
Il parsing degli URL scompone una stringa URL nei suoi componenti individuali secondo RFC 3986. Ogni componente ha regole specifiche su quali caratteri sono ammessi e cosa significano.
- Protocollo (schema) — il metodo utilizzato per accedere alla risorsa: http, https, ftp, mailto o schemi personalizzati come myapp://
- Host — il nome di dominio o l'indirizzo IP del server. Puo includere sottodomini (api.example.com) o essere un indirizzo IPv4/IPv6
- Percorso — la posizione specifica della risorsa sul server. I segmenti sono separati da barre e possono contenere caratteri codificati
Prova gratuitamente — nessuna registrazione richiesta
Analizza URL →Lavorare con i parametri di query
I parametri di query sono coppie chiave-valore aggiunte a un URL dopo il punto interrogativo (?). Sono il modo piu comune per passare dati nelle richieste GET e sono ampiamente utilizzati in API, tracciamento analitico e funzionalita di ricerca.
- Formato base — i parametri usano coppie chiave=valore separate da ampersand: ?page=2&sort=name&order=asc
- Codifica URL — i caratteri speciali devono essere codificati in percentuale: gli spazi diventano %20 o +, gli ampersand nei valori diventano %26
- Parametri array — alcune API usano chiavi ripetute (color=red&color=blue) o notazione con parentesi per gli array
- Valori vuoti e mancanti — ?key= (stringa vuota) differisce da ?key (nessun valore) in molti framework server
- Ordine dei parametri — tecnicamente i parametri URL non sono ordinati, ma alcune API dipendono dall'ordine per caching o validazione della firma
Consigli per il debug degli URL
Gli URL che sembrano corretti a prima vista possono contenere sottili problemi di codifica, componenti mancanti o caratteri inattesi. Questi consigli aiutano a individuare rapidamente i problemi comuni.
- Sempre decodificare prima di leggere — gli URL codificati in percentuale sono difficili da leggere. Decodifica prima per vedere i valori effettivi inviati
- Controlla la doppia codifica — %2520 significa che il segno percentuale stesso e stato codificato (%25 = %), indicando una doppia codifica
- Attenzione alle barre finali — /api/users e /api/users/ possono essere instradati diversamente a seconda della configurazione del server
- Ispeziona il frammento — il frammento hash non viene mai inviato al server. Se il codice lato server ne ha bisogno, serve un approccio diverso
- Valida l'host — gli errori di battitura nei nomi di dominio sono comuni. Controlla punti mancanti, caratteri scambiati o TLD sbagliati
Domande frequenti
Qual e la differenza tra URL, URI e URN?
URI (Uniform Resource Identifier) e il termine generale per qualsiasi identificatore di risorsa. URL (Uniform Resource Locator) e un URI che include la posizione e il metodo di accesso. URN (Uniform Resource Name) e un URI che nomina una risorsa senza specificarne la posizione. In pratica, la maggior parte delle persone usa URL e URI in modo intercambiabile.
Perche alcuni caratteri URL sono codificati con segni di percentuale?
La codifica URL converte i caratteri con significato speciale negli URL in un formato sicuro. Ad esempio, uno spazio diventa %20 perche gli spazi non sono validi negli URL. L'ampersand (&) separa i parametri di query, quindi un ampersand letterale in un valore deve essere codificato come %26.
Quanto puo essere lungo un URL?
Non c'e un limite ufficiale nella specifica HTTP. La maggior parte dei browser supporta URL fino a circa 2.048 caratteri. I browser moderni come Chrome supportano fino a 2MB. I limiti lato server variano. Per la massima compatibilita, mantieni gli URL sotto i 2.000 caratteri e usa richieste POST per grandi carichi di dati.