Codificar y decodificar URL

Elija codificar cuando un texto deba viajar de forma segura como componente de una URL, o decodificar para interpretar escapes porcentuales de registros, redirecciones, consultas y enlaces copiados. La operación es determinista, no conserva estado y rechaza secuencias defectuosas en vez de producir resultados engañosos. Puede ejecutarla en el navegador o usar la misma lógica mediante la API por $0.002 por elemento.

Cuándo conviene aplicar codificación porcentual

Las URL reservan varios caracteres para su estructura: las barras separan segmentos, el signo de interrogación inicia la consulta, los ampersands separan parámetros, el signo igual divide nombres y valores, y la almohadilla introduce fragmentos. Si uno de ellos pertenece al dato, debe evitarse que se confunda con esa estructura. La codificación convierte la entrada a UTF-8 y representa cada byte que no sea un carácter no reservado de RFC 3986 mediante un signo de porcentaje y dos dígitos hexadecimales. Letras, cifras, guiones, puntos, guiones bajos y virgulillas permanecen legibles. Los espacios se convierten en <code>%20</code>, no en un signo más, y la puntuación reservada se escapa porque la entrada se trata como un valor, no como una URL completa. Codifique únicamente el componente que inserta; si codifica una URL ya montada, también escapará sus separadores estructurales.

Cómo protege sus datos la decodificación estricta

La decodificación examina toda la entrada antes de devolver un valor. Cada signo de porcentaje debe ir seguido exactamente de dos dígitos hexadecimales; por eso <code>%</code>, <code>%2</code> y <code>%GG</code> generan un error de entrada no válida. Tras esa comprobación, los bytes escapados deben formar UTF-8 válido. Una secuencia puede parecer correcta y aun representar texto dañado; aceptarla con caracteres de sustitución ocultaría corrupción en registros, devoluciones de llamada o conjuntos importados. Por ello se informa del error. Un signo más no se convierte en espacio: esa regla pertenece a los formularios HTML, mientras que aquí se sigue RFC 3986. Además, solo se realiza una pasada. Así, <code>%2520</code> produce <code>%20</code>, no un espacio; una segunda pasada debe solicitarse expresamente para evitar una doble decodificación accidental.

Cómo utilizar el resultado con seguridad

Seleccione el modo de forma consciente y envíe la cadena exacta que represente un único valor lógico. Al codificar, inserte el resultado sin volver a pasarlo por otro codificador, porque la doble codificación transforma cada porcentaje en <code>%25</code>. Al decodificar, considere el texto obtenido como dato, no como marcado fiable, ruta de archivo o instrucción. Recuperar caracteres no valida su significado para el destino posterior. Esta diferencia importa al recibir parámetros de retorno, revisar registros, normalizar enlaces o comparar identificadores. El algoritmo no usa red, azar, reloj ni estado, por lo que una entrada idéntica siempre produce la misma salida. El navegador resulta práctico para investigar un valor aislado; la API permite incorporar una validación repetible en pruebas y procesos. Cada elemento cuesta $0.002 mediante la API.