Anatomía de una URL según RFC 3986 y el estándar WHATWG
Un Localizador Uniforme de Recursos (URL) moderno se rige por la especificación RFC 3986 de IETF y el estándar vivo WHATWG URL Standard implementado en todos los navegadores y entornos de ejecución como Node.js, Deno y Bun. Cada URL se descompone en segmentos deterministas:
-
Protocolo (Scheme): Define el mecanismo de transporte
(por ejemplo,
https:,wss:) y determina el puerto predeterminado (443para HTTPS,80para HTTP). -
Autoridad (Host y Puerto): Incluye el nombre de dominio
(
api.example.com) o dirección IP y un puerto explícito opcional (como:8443). -
Ruta (Pathname): Identifica el recurso jerárquico en el
servidor (por ejemplo,
/v1/search). -
Cadena de consulta (Query String): Comienza con
?y almacena pares clave-valor separados por¶ filtrado, paginación o seguimiento. -
Fragmento (Hash): Comienza con
#y se procesa exclusivamente en el cliente sin enviarse en las solicitudes HTTP al servidor.
Codificación de espacios: RFC 3986 (%20) frente a application/x-www-form-urlencoded (+)
Una de las fuentes más frecuentes de errores sutiles en integraciones de API REST y firmas OAuth es la discrepancia entre dos estándares de codificación de espacios dentro de los parámetros de consulta:
-
RFC 3986 (Porcentaje estricto
%20): Exige que los espacios en URI se codifiquen como%20. Es el formato requerido por la firma AWS Signature V4, endpoints OAuth 2.0 y parsers modernos basados en RFC. -
HTML Form Encoding (
+): La API nativaURLSearchParamssigue la especificaciónapplication/x-www-form-urlencoded, serializando los espacios como el carácter+.
Este constructor le permite alternar instantáneamente entre ambos modos de serialización y exportar comandos cURL seguros para POSIX con comillas simples escapadas o estructuras JSON listas para clientes HTTP.
Casos de Uso Prácticos en el Mundo Real
-
Depuración de redirecciones OAuth 2.0 y OpenID Connect:
Inspeccione y edite parámetros
redirect_uri,state,code_challengeyscopeanidados sin decodificar cadenas manualmente. -
Pruebas de APIs REST y paginación desde terminal:
Active o desactive parámetros individuales mediante casillas de
verificación y copie el comando
curl -X GETescapado para POSIX directamente en su consola. -
Desinfección de enlaces con rastreadores publicitarios:
Elimine en un clic parámetros
utm_*,gclidyfbclidantes de compartir enlaces en documentación técnica, o cree campañas limpias con nuestro Constructor de Enlaces UTM.
Limpieza de parámetros UTM y agrupación de claves repetidas
Elimine con un solo clic etiquetas de seguimiento publicitario
(utm_source, utm_medium, utm_campaign,
gclid, fbclid) y exporte parámetros con claves
duplicadas directamente como arreglos JSON tipados.
Preguntas Frecuentes (FAQ)
¿Cuál es la diferencia entre codificar espacios como %20 (RFC 3986) o como + (Formulario)?
El estándar RFC 3986 exige %20 para espacios en URIs (usado en firmas OAuth y AWS Signature V4), mientras que URLSearchParams sigue application/x-www-form-urlencoded y usa el signo +.
¿Cómo se exportan los parámetros de consulta duplicados a JSON?
Las claves únicas se exportan como cadenas simples y las claves repetidas (como ?tag=a&tag=b) se agrupan automáticamente en un arreglo JSON de cadenas.