Codificador Q de cabeceras
Ponga acentos en el asunto o en el nombre del remitente de un correo sin que se rompan: Hello café se convierte en =?UTF-8?Q?Hello_caf=C3=A9?=, y una palabra codificada pegada vuelve a texto legible. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Texto
- Hello café
- Modo de cálculo
- Encode
- Resultado
- =?UTF-8?Q?Hello_caf=C3=A9?=
- Codificación
- rfc2047-q
- Juego de caracteres
- UTF-8
- Forma
- Encoded word
Este codificador Q de cabeceras convierte texto UTF-8 plano a la forma Q de RFC 2047 usada en las palabras codificadas MIME de cabeceras de correo no ASCII, y decodifica esas cadenas de nuevo a texto legible. A diferencia del quoted-printable del cuerpo, la codificación Q de cabecera asigna cada espacio a un guion bajo, prohíbe saltos de línea blandos dentro de una palabra codificada y reserva el signo de interrogación y el guion bajo para que los analizadores de correo no confundan la carga útil con el marco =? charset? Q? …? =. Elija codificar para convertir un fragmento de asunto, un nombre para mostrar o una frase de prueba en un token de cabecera seguro para el transporte, o decodificar para recuperar el texto original desde una carga Q o una palabra codificada completa que ya posea. El motor es totalmente determinista: la misma entrada, modo, charset y forma producen siempre el mismo resultado, sin llamadas de red, sales aleatorias ni atajos dependientes de la fecha. Comprobaciones habituales: codificar Hello café a =? UTF-8? Q? Hello_caf=C3=A9? = y decodificar esa cadena al fraseo original.
Qué es la codificación Q de RFC 2047 y qué devuelve esta herramienta
RFC 2047 define las palabras codificadas para que las cabeceras de correo que históricamente esperaban sobre todo ASCII sigan pudiendo llevar texto internacional sin romper las reglas de camino SMTP. Una palabra codificada tiene el aspecto igual-interrogación charset interrogación codificación interrogación carga interrogación-igual, donde la letra de codificación es Q para el método similar a quoted-printable o B para Base64.
El método Q mantiene legible la mayor parte del texto latino en un terminal simple: el ASCII imprimible seguro aparece tal cual, el espacio se escribe preferentemente como guion bajo, y cualquier otro octeto se convierte en un signo igual seguido de dos dígitos hexadecimales en mayúsculas. El signo igual, el signo de interrogación y el guion bajo deben escaparse cuando aparecen como datos, porque son estructurales en la gramática de la palabra codificada.
Los saltos de línea blandos del quoted-printable de cuerpo no aplican aquí: una palabra codificada es un token atómico y no debe contener una secuencia de salto blando.
Esta página sigue siempre ese contrato para texto UTF-8 por defecto: el modo encode mapea su cadena a bytes del charset, emite guion bajo por espacio e igual-hex por bytes inseguros y, opcionalmente, envuelve la carga como palabra codificada completa; el modo decode acepta una palabra codificada completa o una carga Q desnuda, expande guion bajo y pares igual-hex, y rechaza secuencias incompletas o no hexadecimales en lugar de adivinar.
Si necesita empaquetado binario opaco en cabeceras, prefiera el método B o un ayudante Base64; esta página es para la vía Q legible que siguen usando asuntos y nombres para mostrar cada día.
Dónde aparece la codificación Q en las cabeceras del correo
Los desarrolladores se encuentran con la codificación Q de RFC 2047 al inspeccionar líneas Subject que empiezan por igual-interrogación UTF-8 interrogación Q, al elaborar nombres para mostrar internacionales en cabeceras From y To, o al depurar por qué un acento de café se convirtió en guion bajo y pares igual-hex en un volcado de mensaje en bruto.
Los equipos de frontend y soporte decodifican fragmentos Q durante la investigación de tickets sin pegar datos en scripts ad hoc que tratan mal el guion bajo por espacio o confunden el quoted-printable del cuerpo con las reglas Q de cabecera. Los servicios backend codifican muestras de configuración o cadenas multilingües cortas antes de ponerlas en campos de cabecera donde no se garantiza transporte de 8 bits sin restricciones.
Los ingenieros de calidad generan pares deterministas de encode y decode para pruebas de contrato, de modo que una biblioteca de correo que afirme soportar RFC 2047 no pueda cambiar en silencio el uso de mayúsculas en hex, dejar espacios sin escapar o aceptar secuencias igual rotas. Los educadores usan la misma herramienta al enseñar la diferencia entre saltos blandos del quoted-printable de cuerpo y átomos Q de cabecera que deben permanecer en un solo token.
Combínelo con ayudantes MIME quoted-printable cuando trabaje en cuerpos y no en cabeceras, y con ayudantes Base64 cuando una palabra codificada B sea la elección correcta para datos de cabecera densos de aspecto binario.
Qué puede hacer con ella
Depuración de Subject y nombre para mostrar
Codifique o decodifique fragmentos Subject y From de nombre para mostrar en Q de RFC 2047 para que acentos y espacios coincidan con lo que muestran los clientes de correo.
Preparación de cabeceras en pasarelas heredadas
Convierta texto plano UTF-8 en tokens de cabecera codificados en Q seguros para el transporte antes de enviarlos por caminos de correo de 7 bits restringidos.
Preguntas frecuentes
¿Cuánto cuesta el codificador Q de cabeceras?
Es gratis en su navegador en esta página.
¿En qué se diferencia la codificación Q de cabecera del quoted-printable de cuerpo?
La codificación Q de cabecera (RFC 2047) asigna el espacio a guion bajo, prohíbe saltos de línea blandos dentro de una palabra codificada y trata =, ? y _ como especiales.
¿Qué ocurre si una secuencia de escape está mal formada?
Un =XX incompleto, dígitos no hexadecimales tras = o caracteres ilegales en una carga Q se rechazan en lugar de adivinarse.
¿Por qué los espacios aparecen como guiones bajos?
Porque una palabra codificada debe ser un único bloque sin huecos dentro de la cabecera, así que el método Q escribe cada espacio como guion bajo. Al decodificar, cada guion bajo vuelve a ser un espacio, y un guion bajo real del texto se escapa.
¿Qué significa el =?UTF-8?Q? del principio?
Es la envoltura de la palabra codificada: primero el juego de caracteres, luego la letra Q del método y después el texto codificado, que se cierra con ?=. La herramienta la añade al codificar, salvo que usted pida solo el contenido.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/enc/quoted-printable-q \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Hello café"}'const res = await fetch("https://api.kit.forhosting.com/enc/quoted-printable-q", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "Hello café"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/quoted-printable-q",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "Hello café"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/quoted-printable-q", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"Hello café"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"Hello café"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/quoted-printable-q", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"text": "Hello café"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.quoted_printable_q",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
Úselo gratis en el navegador para depurar correo y practicar cabeceras, o llame a la API a $0.002 por solicitud correcta cuando los pipelines necesiten transformaciones RFC 2047 reproducibles en CI y servicios backend.
Qué es la codificación Q de RFC 2047 y qué devuelve esta herramienta
La respuesta JSON incluye result para la cadena transformada, mode que repite encode o decode, encoding fijo a rfc2047-q, charset, form (encoded_word o payload), el campo payload desnudo para aserciones fáciles, e input_bytes más output_bytes para fijar tamaños en pruebas. No hay ruta de streaming ni reparación silenciosa de texto Q roto: o la cadena es válida o la solicitud falla con invalid_input.
Cómo se leen text, mode, charset y form y cómo se mantienen resultados reproducibles
Charset por defecto es UTF-8 y se escribe en la palabra codificada al codificar; al decodificar una palabra codificada completa el charset se toma del propio token, y al decodificar una carga desnuda el parámetro charset elige cómo los bytes recuperados se convierten en texto. charset? Q? …? Encode acepta cadenas Unicode, las convierte con las reglas del charset elegido y emite tokens Q con escapes hexadecimales en mayúsculas y guion bajo por cada espacio. Tras recuperar los bytes, una decodificación UTF-8 fatal evita que basura binaria se convierta en mojibake cuando el charset es UTF-8. El campo de carga preferido es text, con alias input, value y s, de modo que formularios, cadenas de consulta y clientes SDK reutilicen el mismo contrato sin renombrar columnas. Mode tiene por defecto encode y acepta decode de forma explícita; los alias op, direction y action mapean al mismo conmutador para scripts que ya usan esos nombres. Form por defecto es encoded_word para que encode devuelva una cadena completa =? Decode exige una cadena Q bien formada: un igual solo al final de la entrada, un igual seguido de un solo carácter, o un igual seguido de dígitos no hexadecimales fallan con un mensaje invalid_input claro que nombra el escape mal formado. Combine la ejecución gratuita del navegador en esta página con la API de pago cuando necesite el resultado matemático idéntico dentro de un pipeline automatizado sin reimplementar usted las tablas RFC 2047. Las entradas inválidas devuelven invalid_input y no se cobran, lo que mantiene barata la validación mientras las transformaciones correctas siguen un precio fijo por ítem de $0.002.
Dónde encaja la codificación Q en cabeceras de correo, MIME y fixtures de prueba
En esta página el trabajo se ejecuta por completo en su navegador; a través de la API cada consulta correcta cuesta $0.002, la validación fallida no se cobra y no se almacena nada tras devolver la respuesta. Esa división — exploración interactiva gratuita y una API de precio idéntico en resultado — encaja con el resto del catálogo KIT de nivel A y le permite pasar de una demo de aula a un pipeline automatizado sin cambiar el resultado codificado.
Casos de integración
Generación de fixtures de cabecera de correo
Produzca palabras codificadas reproducibles para pruebas unitarias, archivos golden y comprobaciones de integración SMTP o IMAP que afirmen la forma de la cabecera.
Preguntas técnicas
¿Qué modos y formas se admiten?
mode=encode (predeterminado) convierte texto plano en codificación Q; mode=decode convierte una cadena Q de nuevo en texto. form=encoded_word (predeterminado al codificar) envuelve como =?charset?Q?payload?=; form=payload devuelve solo el cuerpo Q interno.
¿El resultado es determinista?
Sí. El mismo text, mode, charset y form producen siempre el mismo resultado, sin red, aleatoriedad ni comportamiento dependiente de la fecha.