{"canonical_url":"https://engineer.company/es/glossary/url/","content_markdown":"# URL\n\n## Qué es\n\nUna URL, abreviatura de Uniform Resource Locator, que en el habla cotidiana se\nllama dirección web o simplemente enlace, es una línea de texto que identifica\nun recurso e indica al software cómo obtenerlo: qué protocolo usar, a qué\nmáquina dirigirse y qué pedirle. Al pegarla en un navegador, una terminal o un\narchivo de configuración, cualquiera de ellos puede utilizarla sin más ayuda.\n\nSu estructura la fija la sintaxis genérica que comparten todos los esquemas:\n\n```text\nhttps://shop.example.com:8443/orders/42?view=full#items\n\nscheme     https\nhost       shop.example.com\nport       8443\npath       /orders/42\nquery      view=full\nfragment   items\n```\n\nEl esquema indica cómo llegar al recurso; aquí, mediante HTTP sobre TLS. El\nnombre de host y el puerto opcional indican dónde, la ruta identifica el recurso de\nese servidor y la consulta lleva parámetros, normalmente como pares\n`name=value` unidos por `\u0026`. El fragmento situado tras `#` apunta al interior\ndel resultado, a un encabezado o una posición. Pertenece al cliente: el\nnavegador lo omite del destino de la petición HTTP. Eso no lo hace secreto para\nel servidor, porque el código del cliente puede leerlo y enviarlo\nexplícitamente en otra petición.\n\nDado que caracteres como `/`, `?`, `#`, `\u0026` y `=` cumplen funciones dentro de esa\nestructura, los datos que entrarían en conflicto con un delimitador del\ncomponente que se está construyendo deben codificarse con porcentajes: se\nescriben como `%` seguido de dos dígitos hexadecimales. Qué caracteres necesitan\nese tratamiento depende del componente y de su sintaxis. Un espacio se\nconvierte en `%20`, un ampersand dentro del valor de un parámetro de consulta,\nen `%26`, y el propio signo de porcentaje, en `%25`. Las letras ajenas a ASCII\nviajan igual, como sus bytes UTF-8; así pasan las palabras danesas o ucranianas\nde una ruta.\n\n¿Es lo mismo una URL que una URI? Casi. Una URI, Uniform Resource Identifier,\nes cualquier cadena con esa sintaxis que identifica algo; una URL es la clase\nque además indica cómo localizarlo, mientras que `urn:isbn:9780000000002`\nidentifica un libro sin ofrecer una forma de obtenerlo. RFC 3986 pide que las\nespecificaciones nuevas usen URI. El estándar URL de WHATWG, que siguen los\nnavegadores, tomó el camino contrario: eligió URL como término único y se\npropuso describir lo que hacen las implementaciones reales, con la intención\nde sustituir al RFC. Coinciden en las direcciones habituales y discrepan en\ncasos límite, algo que conviene recordar cuando un navegador y una biblioteca\ndel servidor analizan la misma cadena extraña.\n\n## Por qué importa\n\nUna URL publicada es un compromiso. Acaba en marcadores, índices de búsqueda,\ncorreos, folletos impresos, registros de conversaciones y páginas ajenas, y\nninguna de esas copias se actualiza sola. Cambiar después la dirección rompe\ntodas esas referencias, salvo que la antigua siga respondiendo con una\nredirección a la nueva.\n\nPor eso conviene decidir pronto de qué se construye la dirección. Todo lo que\npueda cambiar es una mala base: el título de una página, un árbol de categorías,\nun nombre de producto o una extensión que revela el framework actual. Un\nidentificador breve, o un slug guardado como dato y editado de forma deliberada,\nperdura. También hace falta un plan para cuando una dirección deba trasladarse:\nla antigua debe convertirse en una redirección permanente, en lugar de un 404.\n\nLa segunda decisión es qué dejar fuera. RFC 9110 lo expresa con claridad: las\ndirecciones están hechas para compartirse, no para mantenerse protegidas. Se\nescriben en los registros de servidores y proxies, quedan en el historial del\nnavegador, se copian en las herramientas de analítica y, según la política, se\nenvían en la cabecera `Referer` a los recursos que la página carga después.\nLos identificadores de sesión, tokens de restablecimiento, claves de API y\ndatos personales deben ir en cabeceras o cuerpos de petición.\n\nLa longitud es una cuestión menor. La especificación HTTP recomienda que el\nsoftware acepte direcciones de al menos 8.000 octetos, una cifra generosa, pero\nuna cadena de consulta que lleve un formulario entero o un filtro serializado\nsuele encontrar un límite menor en algún punto de la cadena antes de llegar a\nesa longitud.\n\n## Cómo se aplica en la práctica\n\nEl trabajo de este sitio trata las direcciones como datos que sobreviven al\ntexto de la página. Cuando se\n[generaron 495 páginas de logros en tres idiomas desde una exportación SQLite de solo lectura](/es/portfolio/generated-495-pages-from-a-sqlite-export/),\nen la etapa de implementación documentada de agosto de 2026, la decisión más\ntrascendente afectó a la dirección. El sitio había derivado la URL de una\npágina de las primeras palabras de su enunciado en inglés, de modo que corregir\nuna frase trasladaba la página sin avisar y rompía todos sus enlaces. Después,\nla dirección pasó a redactarse como dato, con una fila por dirección y logro:\nla primera era la vigente y las posteriores eran direcciones retiradas que el\nsitio publicaba como redirecciones. El resultado registrado fue que todas las\ndirecciones publicadas hasta aquella etapa seguían respondiendo.\n\nUna nota sobre monederos móviles muestra qué ocurre cuando una URL viaja dentro\nde otra.\n[Phantom, Solflare y Backpack abren una dApp mediante enlaces universales](/es/notes/solana-mobile-wallet-deeplinks/)\nque llevan la dirección de destino en su propia ruta y el origen solicitante\nen un parámetro `ref`, pasando ambos por `encodeURIComponent`. Un `?` o `\u0026`\nsin codificar en el destino corrompe el análisis y el monedero se abre en su\npantalla inicial, en lugar de la pestaña del navegador. Un esquema personalizado\nsupuesto, como `backpack://`, sale peor parado: la aplicación no registra\nninguna ruta que coincida con él y el usuario acaba en la página de instalación.\n\nLas direcciones también sirven de identidad. Cuando se\n[sustituyeron 963 bloques de datos estructurados por un único grafo enlazado](/es/portfolio/replaced-963-metadata-blocks-with-one-graph/),\nlos identificadores de la organización, el sitio y la persona se crearon a\npartir del origen del sitio, y las páginas de listas publican sus elementos\nsolo mediante la URL. En la etapa de implementación documentada de julio de\n2026 se midió esa elección: incluir los nombres de los elementos en el índice\ndel portafolio habría supuesto 107 enunciados completos y una página comprimida\nun 52 % mayor. La comprobación que protege el grafo exige que se haya generado\nrealmente cada URL que este menciona.\n\n## Dónde surgen los problemas\n\nLos fallos de las URL suelen ser discretos. La dirección sigue pareciendo\ncorrecta; simplemente apunta a otro sitio o revela más de lo previsto.\n\n**No se codifica, o se codifica dos veces.** Una dirección de retorno colocada\nsin codificar en una consulta, como `?next=/cart?item=4\u0026size=m`, se divide en el\n`\u0026` sin codificar, y el servidor interpreta `size=m` como un parámetro propio.\nCodificar una cadena ya codificada convierte `%20` en `%2520`, y la página\nrecibe un `%20` literal. Codifique cada componente exactamente una vez, cuando\nlo incorpore a la dirección, con la función destinada a componentes. En\nJavaScript es `encodeURIComponent`; `encodeURI` deja intactos `?`, `\u0026` y `#`\nporque espera una dirección completa.\n\n**Un secreto viaja en la cadena de consulta.** Un token para restablecer una\ncontraseña o una clave de API en la URL se copia en los registros de acceso,\nel historial y la analítica. Con una política de referencia permisiva, se envía\nen `Referer` a cada tercero del que la página carga recursos. Ponga las\ncredenciales en una cabecera. Cuando un token deba viajar en un enlace, como en\nun correo de restablecimiento, hágalo de un solo uso y de corta duración, y\nestablezca una `Referrer-Policy` que impida que salga de su sitio.\n\n**Una página responde en cinco direcciones.** `http` y `https`, con y sin\n`www`, con y sin barra final, `/About` y `/about`. Por definición, el esquema y\nel nombre de host no distinguen mayúsculas de minúsculas; la ruta sí, salvo que el\nservidor decida lo contrario. Los buscadores reparten la reputación de la\npágina entre las copias, las cachés guardan cada una por separado y la analítica\nlas cuenta como distintas. Elija una forma, redirija permanentemente todas las\ndemás a ella y declárela canónica.\n\n**Un enlace relativo se resuelve con la base equivocada.** Una referencia como\n`img/logo.png` sustituye todo lo que va tras la última barra de la ruta actual.\nEn `/docs/guide` se resuelve como `/docs/img/logo.png`; en `/docs/guide/`, como\n`/docs/guide/img/logo.png`. Una sola barra final cambia todos los enlaces\nrelativos de la página. Los enlaces relativos a la raíz, que empiezan por `/`,\nevitan el problema.\n\n**La lógica depende del fragmento.** Las redirecciones del servidor, los\nregistros de acceso y la analítica que leen el destino de la petición HTTP no\nreciben `#` ni su fragmento. El cliente puede enviarlo por separado cuando la\naplicación lo necesita. Todo lo que deba llegar al servidor como parte de la\npetición inicial debe ir en la ruta o en la consulta.\n\n## Lecturas adicionales\n\n- [RFC 3986: Uniform Resource Identifier (URI): Generic Syntax](https://www.rfc-editor.org/rfc/rfc3986)\n  — la gramática, la codificación con porcentajes, la resolución relativa y la\n  normalización.\n- [WHATWG URL Standard](https://url.spec.whatwg.org/) — el algoritmo de análisis\n  que implementan los navegadores, paso a paso.\n- [RFC 3987: Internationalized Resource Identifiers](https://www.rfc-editor.org/rfc/rfc3987)\n  — cómo las direcciones escritas con cualquier sistema de escritura se\n  corresponden con bytes codificados con porcentajes.\n- [RFC 8820: URI Design and Ownership](https://www.rfc-editor.org/rfc/rfc8820)\n  — por qué el propietario de un host, y nadie más, decide cómo son sus rutas.\n- [RFC 9110, sección 17.9](https://www.rfc-editor.org/rfc/rfc9110#section-17.9)\n  — la nota de seguridad sobre información sensible en las direcciones.\n\n\u003chttps://engineer.company/es/glossary/url/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Las partes de una URL, su relación con las URI y cómo conservar direcciones estables sin errores de codificación ni duplicados.","formats":{"gemtext":"https://engineer.company/es/glossary/url/index.gmi","gopher":"https://engineer.company/es/glossary/url/gophermap","html":"https://engineer.company/es/glossary/url/","json":"https://engineer.company/es/glossary/url/index.json","markdown":"https://engineer.company/es/glossary/url/index.md","pdf":"https://engineer.company/es/glossary/url/index.pdf"},"kind":"page","language":"es","title":"¿Qué es una URL?","url":"https://engineer.company/es/glossary/url/","version":1}