HTTP QUERY RFC 10008: el nuevo método para APIs en 2026

El primer nuevo método HTTP en más de 20 años acaba de llegar

En junio de 2026, la IETF publicó el RFC 10008 definiendo el método HTTP QUERY, el primer nuevo método HTTP estandarizado en más de dos décadas. Este estándar permite enviar consultas complejas con cuerpos de petición grandes manteniendo la seguridad e idempotencia de GET, resolviendo un problema histórico en el diseño de APIs RESTful.

Para founders que construyen SaaS o APIs, esto significa poder diseñar endpoints más limpios, cacheables por defecto y sin los límites de longitud de URL que hoy obligan a usar POST para operaciones de lectura.

¿Qué es exactamente el método HTTP QUERY?

El método QUERY solicita que el servidor procese el contenido incluido en el cuerpo de la petición de manera segura (no modifica el estado del recurso) e idempotente (repetir la petición no causa efectos adicionales), respondiendo con el resultado de ese procesamiento.

👥 ¿Quieres ir más allá de la noticia?

En nuestra comunidad discutimos las tendencias, compartimos oportunidades y nos ayudamos entre emprendedores. Sin humo, solo acción.

👥 Unirme a la comunidad

A diferencia de GET, que envía parámetros en la URL con límites de longitud (típicamente 2000-8000 caracteres según el servidor), QUERY permite enviar el contenido de la consulta en el body de la petición, similar a POST, pero con semántica explícitamente segura.

El RFC especifica que las implementaciones pueden fallar más allá de 8000 caracteres, aunque no garantiza comportamiento hasta ese límite. Esto sigue siendo significativamente mayor que los límites prácticos de URL en muchos servidores y proxies.

¿Por qué no basta con GET o POST?

Durante años, los desarrolladores han enfrentado un dilema en el diseño de APIs:

GET con parámetros en URL:

✅ Seguro e idempotente por definición
✅ Cacheable automáticamente por navegadores y CDNs
❌ Límite de longitud de URL (varía por servidor, típicamente 2-8KB)
❌ Parámetros complejos requieren encoding especial

POST con cuerpo:

✅ Sin límites prácticos de longitud
✅ Soporta JSON, SQL, formatos complejos
❌ No es seguro (puede modificar estado)
❌ No es idempotente por defecto
❌ No cacheable automáticamente
❌ Los clientes no pueden reintentar automáticamente sin riesgo

QUERY combina lo mejor de ambos: cuerpo grande como POST, pero seguro e idempotente como GET, permitiendo caché automático y reintentos seguros sin preocuparse por cambios parciales de estado.

Casos de uso concretos para tu API

Consultas SQL complejas

Imagina un endpoint de reporting donde los usuarios aplican múltiples filtros, joins y agregaciones. Con GET, la URL se vuelve ilegible y excede límites. Con QUERY, envías la consulta completa en el body:

QUERY /reports HTTP/1.1
Content-Type: application/json

{
  "select": ["revenue", "region", "date"],
  "where": {"date": {"gte": "2025-01-01"}},
  "groupBy": ["region"],
  "orderBy": "revenue DESC"
}

Búsqueda avanzada con filtros JSON

Marketplaces, directorios y plataformas de contenido suelen necesitar filtros complejos (rango de precios, categorías múltiples, ubicación geográfica, atributos personalizados). QUERY permite enviar objetos JSON completos sin violar principios REST.

Variante con estado: prepared statements

El RFC menciona una variante interesante: el cliente envía una QUERY con la consulta completa, y el servidor devuelve una URL GET preparada para futuras llamadas. Similar a los prepared statements en SQL, esto permite cachear la consulta compilada y reutilizarla con una simple petición GET posterior.

¿Qué frameworks y servidores lo soportan en 2026?

Dado que el RFC 10008 se publicó apenas en junio de 2026, la adopción está en etapa inicial:

Spring (Java): Tiene un pull request pendiente que se espera se incluya en las próximas versiones. El RFC se ratificó apenas la semana previa a la publicación, por lo que los maintainers están actualizando.

Nginx y Apache: Requieren ajustes de configuración para reconocer el método QUERY y responder adecuadamente a las peticiones OPTIONS para CORS.

Librerías HTTP: La implementación es relativamente sencilla (añadir una etiqueta de método), por lo que se espera adopción rápida en herramientas como curl, httpie (Python) y clientes HTTP populares.

CORS: Las peticiones QUERY desde navegadores requieren una petición "preflight" OPTIONS, ya que QUERY no está en el conjunto de métodos "safelisted" (como GET o POST). Los servidores deben configurar explícitamente Access-Control-Allow-Methods: QUERY en las respuestas OPTIONS.

¿Qué significa esto para tu startup?

Si estás construyendo una API en 2026, HTTP QUERY ofrece ventajas concretas que impactan directamente en arquitectura y experiencia de desarrollador:

1. APIs más RESTful y predecibles

Hoy muchos equipos usan POST para operaciones de lectura porque GET no soporta cuerpos grandes. Esto viola principios REST y confunde a consumidores de la API. QUERY permite mantener la semántica correcta: GET para recursos simples, QUERY para consultas complejas, POST para creación, PUT/PATCH para actualización, DELETE para eliminación.

2. Caché automático sin configuración adicional

Al ser seguro e idempotente, las respuestas QUERY pueden ser cacheadas automáticamente por:

Navegadores y móviles
CDNs y proxies inversos
Balanceadores de carga
Servicios como Cloudflare o AWS CloudFront

Esto reduce latencia en consultas repetidas sin código adicional.

3. Reintentos automáticos más seguros

Los clientes HTTP (navegadores, SDKs móviles, librerías) pueden reintentar automáticamente peticiones QUERY fallidas sin riesgo de duplicar efectos secundarios. Con POST, un reintento podría crear recursos duplicados o ejecutar acciones múltiples.

4. Mejor documentación y descubrimiento

Una API que usa QUERY comunica explícitamente su intención: "esta endpoint es para consultar, no para modificar". Esto mejora la documentación implícita y reduce errores de integración.

Acciones concretas para implementar QUERY

Acción 1: Identifica endpoints candidatos en tu API

Revisa tu API actual y busca endpoints que:

Usan POST pero solo leen datos (no modifican estado)
Tienen parámetros de consulta complejos o largos
Necesitarían caché pero no lo tienen por usar POST
Los clientes no pueden reintentar automáticamente

Estos son candidatos ideales para migrar a QUERY una vez que tu stack lo soporte.

Acción 2: Prepara tu infraestructura

Si usas Nginx o Apache, revisa la configuración para asegurar que reconozcan el método QUERY. En Nginx, puedes necesitar:

if ($request_method = QUERY) {
    # Manejar QUERY
}

Para CORS, añade QUERY a los métodos permitidos:

Access-Control-Allow-Methods: GET, POST, QUERY, OPTIONS

Acción 3: Monitorea la adopción de frameworks

Si usas Spring, Express, Django, Laravel u otros frameworks populares, sigue los releases de 2026-2027 para cuando añadan soporte nativo a QUERY. Mientras tanto, puedes implementar soporte manual en middleware o controllers.

Acción 4: Documenta para tus consumidores

Si decides usar QUERY, actualiza tu documentación API (OpenAPI/Swagger) para especificar claramente:

Qué endpoints usan QUERY
Qué formatos de body soportan (JSON, SQL, form-urlencoded)
Límites de longitud aplicables
Comportamiento de caché esperado

Conclusión

El método HTTP QUERY (RFC 10008) cierra una brecha histórica en el protocolo HTTP, ofreciendo una solución estándar para consultas complejas que antes obligaban a elegir entre la simplicidad de GET y la capacidad de datos de POST.

Para founders técnicos y equipos de ingeniería, esto significa APIs más limpias, mejor caché por defecto, reintentos más seguros y una semántica RESTful más honesta. Aunque la adopción está en etapa inicial en 2026, los frameworks principales están actualizando y la implementación es sencilla.

La pregunta no es si adoptar QUERY, sino cuándo: si estás diseñando una API nueva o refactorizando una existente, considera QUERY para endpoints de consulta compleja. Tu infraestructura de caché y tus consumidores de API lo agradecerán.