Riparatore di URL
Ripara URL rotti online: virgolette tipografiche, https mancante, doppi slash, codifica mista, ritorni a capo incollati da Word o Slack.
Cos'è il Riparatore di URL?
Hai copiato un link da un'email, un documento Word, un messaggio Slack o una pagina Confluence — e ora c'è circondato da virgolette tipografiche (" al posto di "), con un trattino lungo (–) dove dovrebbe esserci un trattino normale, senza https:// davanti, o con un ritorno a capo finito a metà che ha tagliato in due l'URL. Incollalo qui e ricevi indietro un URL funzionante. Il Riparatore di URL ripulisce i danni sintattici che il copia-incolla lascia dietro di sé, seguendo le regole dello standard URL del WHATWG e dell'RFC 3986.
Il riparatore gestisce le cose che una regex dovrebbe trattare come casi speciali per l'eternità: virgolette tipografiche, trattini tipografici, doppi slash accidentali nel percorso, percent-encoding misto o doppio (così %2520 torna a essere %20 quando è chiaramente una doppia codifica), spazi non codificati e caratteri CR/LF/tab finiti dentro l'URL perché qualcuno ha premuto Invio nel momento sbagliato. Non si inventa un nome host, non cambia i tuoi parametri di query e non aggiunge un segmento di percorso che non c'era. L'output viene poi validato secondo le regole dell'URL API del browser, così sai che verrà parsato anche dall'altra parte. I nomi host internazionalizzati (Unicode, IDN) vengono preservati come da RFC 3987.
Il tuo URL viene mandato al backend perché la riparazione possa girare e poi torna subito indietro. Non logghiamo l'input: gli URL portano spesso token di sessione, ID cliente o altre cose che non vuoi vedere ferme in un file di log. Se il tuo URL contiene un segreto vero (un link S3 firmato, un token di autenticazione usa-e-getta), ruotalo dopo averlo incollato ovunque, anche qui.
Come usare il Riparatore di URL
Tre passaggi. Ognuno corrisponde a un pulsante in questa pagina: non c'è niente di nascosto.
Incolla l'URL rotto o carica l'esempio
Metti il tuo URL rotto nell'editor a sinistra. Clicca URL di esempio per caricare un caso volutamente rotto con virgolette tipografiche, un trattino lungo, schema mancante e uno spazio non codificato — il tipo di cosa che davvero ti capita di incollare da un'email. Esempio di URL rotto:
"shop.example.com/orders/ORD–1001?customer=Ava Chen"Virgolette tipografiche da un Word a circondare l'URL, trattino lungo dentro il segmento di percorso, niente schema, e uno spazio letterale nel valore di query. Quattro problemi distinti in una sola riga corta.
Clicca Ripara URL!!
Premi il pulsante verde Ripara URL!!. Il riparatore toglie le virgolette intorno, sostituisce il trattino lungo con uno normale, antepone https:// e codifica lo spazio in percent-encoding così il risultato rispetta l'RFC 3986.
Copia l'URL riparato
Il pannello di destra mostra l'URL ripulito. Dacci un'occhiata, copialo, incollalo nel browser, nella tua chiamata fetch(), nel README o nel test che stava fallendo. Se vuoi vedere l'URL scomposto nelle sue parti, passalo poi attraverso il nostro URL Parser.
Quando lo useresti davvero
Link incollati da email o Word
Outlook e Word trasformano in silenzio le virgolette dritte in tipografiche e i trattini in trattini lunghi. L'URL sembra a posto nel messaggio e si rompe nel secondo in cui lo incolli in un terminale. Il riparatore annulla quel correttore "intelligente" e il link torna a funzionare.
URL incorniciati dalle virgolette di un logger
I log applicativi in formato JSON adorano stampare gli URL come "https://api.example.com/v1/orders?id=ORD-1001". Quando lo prendi al volo per un curl rapido, le virgolette intorno vengono dietro. Il riparatore le toglie e smetti di chiederti perché la tua shell si lamenta di una virgoletta non chiusa.
Ritorni a capo piazzati a metà URL da Slack o Jira
URL lunghi in Slack, Jira o in una pagina Confluence spesso vanno a capo e si portano dietro un \n casuale quando li copi. Il percorso sembra giusto ma fetch() rifiuta l'URL con un errore di parsing. Il riparatore appiattisce i ritorni a capo e l'URL torna a essere una stringa continua.
Querystring doppiamente codificate
Quando un URL passa da due sistemi che entrambi fanno percent-encoding, ti ritrovi con %2520 dove dovrebbe esserci %20. Il riparatore riporta le doppie codifiche evidenti a un solo strato — utile quando stai debuggando catene di redirect o payload di webhook.
Domande frequenti
Il mio URL viene salvato o mandato da qualche parte che io non vedo?
Il tuo URL va al nostro backend perché la riparazione possa girare e torna subito indietro. Non logghiamo l'input in sé: gli URL portano spesso token di sessione o PII nel percorso/query. Logghiamo che è avvenuta una riparazione, non cosa è stato riparato. Se l'URL contiene un segreto vero (un link firmato, un token di autenticazione), consideralo esposto nel momento in cui lo incolli in qualunque strumento di terze parti, incluso questo, e ruotalo.
Quali tipi di errori URL sistema davvero?
Quelli di tutti i giorni: schema mancante (default https://), virgolette tipografiche/curve intorno all'URL, trattino lungo o em-dash al posto di un trattino normale, // accidentali nel percorso, percent-encoding doppio (%2520 → %20 quando è chiaramente doppio), spazi non codificati nei valori di query, caratteri tab/CR/LF infilati dentro l'URL da un editor di testo, e parentesi angolari intorno tipo <https://example.com> da link Markdown.
Cambierà i valori di percorso, query o frammento?
No. Il riparatore è volutamente conservativo. Non si inventerà un host, non indovinerà un TLD mancante, non aggiungerà o rimuoverà segmenti di percorso, non aggiungerà o rimuoverà parametri di query, non cambierà l'ordine dei parametri e non eliminerà il frammento. Tocca solo i caratteri sintatticamente sbagliati. Se entra customer=Ava Chen, esce customer=Ava%20Chen: stesso valore, solo correttamente codificato secondo RFC 3986.
Supporta i nomi di dominio internazionali (Unicode)?
Sì. I caratteri Unicode nell'host o nel percorso vengono preservati come Internationalised Resource Identifier (forma IRI). Se la tua applicazione ha bisogno della forma punycode (ASCII) dell'host, passa l'URL ripulito attraverso la libreria URL del tuo linguaggio: il modulo url di Node, il pacchetto idna di Python o il costruttore URL nativo del browser ti daranno entrambe le forme.
E gli URL davvero lunghi?
C'è un tetto di 64 KB sull'input — circa 64.000 caratteri. Gli URL reali stanno quasi sempre sotto i 2.000 caratteri; se il tuo è più grosso, di solito è perché qualcosa è stato doppiamente codificato in un blob enorme, o c'è un payload binario nella querystring che dovrebbe stare in un body POST. Il riparatore ti dirà che l'input è troppo grande; accorcia o ristruttura prima.
Mi ha restituito un errore invece di un URL riparato. E ora?
Alcuni input sono troppo compromessi: per esempio un URL in cui manca completamente l'host, o uno la cui struttura è così rovinata che il modello non riesce a capire cosa intendessi. In quel caso, dai un'occhiata all'URL, sistema a mano i problemi più ovvi (host e schema sono i soliti sospetti) e rilancialo. Puoi anche far passare il risultato dal nostro Validatore di URL per vedere esattamente di cosa si lamenta il parser.
Altri strumenti URL che potrebbero servirti
Riparare l'URL è un passaggio. Una volta che parsa pulito, questi strumenti se ne occupano fino in fondo: