# URL

## Qué es

Una URL, abreviatura de Uniform Resource Locator, que en el habla cotidiana se llama dirección web o simplemente enlace, es una línea de texto que identifica un recurso e indica al software cómo obtenerlo: qué protocolo usar, a qué máquina dirigirse y qué pedirle. Al pegarla en un navegador, una terminal o un archivo de configuración, cualquiera de ellos puede utilizarla sin más ayuda.

Su estructura la fija la sintaxis genérica que comparten todos los esquemas:

```text
https://shop.example.com:8443/orders/42?view=full#items

scheme     https
host       shop.example.com
port       8443
path       /orders/42
query      view=full
fragment   items
```

El esquema indica cómo llegar al recurso; aquí, mediante HTTP sobre TLS. El nombre de host y el puerto opcional indican dónde, la ruta identifica el recurso de ese servidor y la consulta lleva parámetros, normalmente como pares `name=value` unidos por `&`. El fragmento situado tras `#` apunta al interior del resultado, a un encabezado o una posición. Pertenece al cliente: el navegador lo omite del destino de la petición HTTP. Eso no lo hace secreto para el servidor, porque el código del cliente puede leerlo y enviarlo explícitamente en otra petición.

Dado que caracteres como `/`, `?`, `#`, `&` y `=` cumplen funciones dentro de esa estructura, los datos que entrarían en conflicto con un delimitador del componente que se está construyendo deben codificarse con porcentajes: se escriben como `%` seguido de dos dígitos hexadecimales. Qué caracteres necesitan ese tratamiento depende del componente y de su sintaxis. Un espacio se convierte en `%20`, un ampersand dentro del valor de un parámetro de consulta, en `%26`, y el propio signo de porcentaje, en `%25`. Las letras ajenas a ASCII viajan igual, como sus bytes UTF-8; así pasan las palabras danesas o ucranianas de una ruta.

¿Es lo mismo una URL que una URI? Casi. Una URI, Uniform Resource Identifier, es cualquier cadena con esa sintaxis que identifica algo; una URL es la clase que además indica cómo localizarlo, mientras que `urn:isbn:9780000000002` identifica un libro sin ofrecer una forma de obtenerlo. RFC 3986 pide que las especificaciones nuevas usen URI. El estándar URL de WHATWG, que siguen los navegadores, tomó el camino contrario: eligió URL como término único y se propuso describir lo que hacen las implementaciones reales, con la intención de sustituir al RFC. Coinciden en las direcciones habituales y discrepan en casos límite, algo que conviene recordar cuando un navegador y una biblioteca del servidor analizan la misma cadena extraña.

## Por qué importa

Una URL publicada es un compromiso. Acaba en marcadores, índices de búsqueda, correos, folletos impresos, registros de conversaciones y páginas ajenas, y ninguna de esas copias se actualiza sola. Cambiar después la dirección rompe todas esas referencias, salvo que la antigua siga respondiendo con una redirección a la nueva.

Por eso conviene decidir pronto de qué se construye la dirección. Todo lo que pueda cambiar es una mala base: el título de una página, un árbol de categorías, un nombre de producto o una extensión que revela el framework actual. Un identificador breve, o un slug guardado como dato y editado de forma deliberada, perdura. También hace falta un plan para cuando una dirección deba trasladarse: la antigua debe convertirse en una redirección permanente, en lugar de un 404.

La segunda decisión es qué dejar fuera. RFC 9110 lo expresa con claridad: las direcciones están hechas para compartirse, no para mantenerse protegidas. Se escriben en los registros de servidores y proxies, quedan en el historial del navegador, se copian en las herramientas de analítica y, según la política, se envían en la cabecera `Referer` a los recursos que la página carga después. Los identificadores de sesión, tokens de restablecimiento, claves de API y datos personales deben ir en cabeceras o cuerpos de petición.

La longitud es una cuestión menor. La especificación HTTP recomienda que el software acepte direcciones de al menos 8.000 octetos, una cifra generosa, pero una cadena de consulta que lleve un formulario entero o un filtro serializado suele encontrar un límite menor en algún punto de la cadena antes de llegar a esa longitud.

## Cómo se aplica en la práctica

El trabajo de este sitio trata las direcciones como datos que sobreviven al texto de la página. Cuando se generaron 495 páginas de logros en tres idiomas desde una exportación SQLite de solo lectura, en la etapa de implementación documentada de agosto de 2026, la decisión más trascendente afectó a la dirección. El sitio había derivado la URL de una página de las primeras palabras de su enunciado en inglés, de modo que corregir una frase trasladaba la página sin avisar y rompía todos sus enlaces. Después, la dirección pasó a redactarse como dato, con una fila por dirección y logro: la primera era la vigente y las posteriores eran direcciones retiradas que el sitio publicaba como redirecciones. El resultado registrado fue que todas las direcciones publicadas hasta aquella etapa seguían respondiendo.

Una nota sobre monederos móviles muestra qué ocurre cuando una URL viaja dentro de otra. Phantom, Solflare y Backpack abren una dApp mediante enlaces universales que llevan la dirección de destino en su propia ruta y el origen solicitante en un parámetro `ref`, pasando ambos por `encodeURIComponent`. Un `?` o `&` sin codificar en el destino corrompe el análisis y el monedero se abre en su pantalla inicial, en lugar de la pestaña del navegador. Un esquema personalizado supuesto, como `backpack://`, sale peor parado: la aplicación no registra ninguna ruta que coincida con él y el usuario acaba en la página de instalación.

Las direcciones también sirven de identidad. Cuando se sustituyeron 963 bloques de datos estructurados por un único grafo enlazado, los identificadores de la organización, el sitio y la persona se crearon a partir del origen del sitio, y las páginas de listas publican sus elementos solo mediante la URL. En la etapa de implementación documentada de julio de
2026 se midió esa elección: incluir los nombres de los elementos en el índice del portafolio habría supuesto 107 enunciados completos y una página comprimida un 52 % mayor. La comprobación que protege el grafo exige que se haya generado realmente cada URL que este menciona.

## Dónde surgen los problemas

Los fallos de las URL suelen ser discretos. La dirección sigue pareciendo correcta; simplemente apunta a otro sitio o revela más de lo previsto.

No se codifica, o se codifica dos veces. Una dirección de retorno colocada sin codificar en una consulta, como `?next=/cart?item=4&size=m`, se divide en el `&` sin codificar, y el servidor interpreta `size=m` como un parámetro propio. Codificar una cadena ya codificada convierte `%20` en `%2520`, y la página recibe un `%20` literal. Codifique cada componente exactamente una vez, cuando lo incorpore a la dirección, con la función destinada a componentes. En JavaScript es `encodeURIComponent`; `encodeURI` deja intactos `?`, `&` y `#` porque espera una dirección completa.

Un secreto viaja en la cadena de consulta. Un token para restablecer una contraseña o una clave de API en la URL se copia en los registros de acceso, el historial y la analítica. Con una política de referencia permisiva, se envía en `Referer` a cada tercero del que la página carga recursos. Ponga las credenciales en una cabecera. Cuando un token deba viajar en un enlace, como en un correo de restablecimiento, hágalo de un solo uso y de corta duración, y establezca una `Referrer-Policy` que impida que salga de su sitio.

Una página responde en cinco direcciones. `http` y `https`, con y sin `www`, con y sin barra final, `/About` y `/about`. Por definición, el esquema y el nombre de host no distinguen mayúsculas de minúsculas; la ruta sí, salvo que el servidor decida lo contrario. Los buscadores reparten la reputación de la página entre las copias, las cachés guardan cada una por separado y la analítica las cuenta como distintas. Elija una forma, redirija permanentemente todas las demás a ella y declárela canónica.

Un enlace relativo se resuelve con la base equivocada. Una referencia como `img/logo.png` sustituye todo lo que va tras la última barra de la ruta actual. En `/docs/guide` se resuelve como `/docs/img/logo.png`; en `/docs/guide/`, como `/docs/guide/img/logo.png`. Una sola barra final cambia todos los enlaces relativos de la página. Los enlaces relativos a la raíz, que empiezan por `/`, evitan el problema.

La lógica depende del fragmento. Las redirecciones del servidor, los registros de acceso y la analítica que leen el destino de la petición HTTP no reciben `#` ni su fragmento. El cliente puede enviarlo por separado cuando la aplicación lo necesita. Todo lo que deba llegar al servidor como parte de la petición inicial debe ir en la ruta o en la consulta.

## Lecturas adicionales
* RFC 3986: Uniform Resource Identifier (URI): Generic Syntax — la gramática, la codificación con porcentajes, la resolución relativa y la normalización.
* WHATWG URL Standard — el algoritmo de análisis que implementan los navegadores, paso a paso.
* RFC 3987: Internationalized Resource Identifiers — cómo las direcciones escritas con cualquier sistema de escritura se corresponden con bytes codificados con porcentajes.
* RFC 8820: URI Design and Ownership — por qué el propietario de un host, y nadie más, decide cómo son sus rutas.
* RFC 9110, sección 17.9 — la nota de seguridad sobre información sensible en las direcciones.

=> /es/portfolio/generated-495-pages-from-a-sqlite-export/ generaron 495 páginas de logros en tres idiomas desde una exportación SQLite de solo lectura
=> /es/notes/solana-mobile-wallet-deeplinks/ Phantom, Solflare y Backpack abren una dApp mediante enlaces universales
=> /es/portfolio/replaced-963-metadata-blocks-with-one-graph/ sustituyeron 963 bloques de datos estructurados por un único grafo enlazado
=> https://www.rfc-editor.org/rfc/rfc3986 RFC 3986: Uniform Resource Identifier (URI): Generic Syntax
=> https://url.spec.whatwg.org/ WHATWG URL Standard
=> https://www.rfc-editor.org/rfc/rfc3987 RFC 3987: Internationalized Resource Identifiers
=> https://www.rfc-editor.org/rfc/rfc8820 RFC 8820: URI Design and Ownership
=> https://www.rfc-editor.org/rfc/rfc9110#section-17.9 RFC 9110, sección 17.9

=> https://engineer.company/es/glossary/url/ Esta página en la web
