GraphQL publica la especificación oficial para su uso sobre HTTP

Fuentes: GraphQL releases official specification for HTTP transport

La comunidad GraphQL ha lanzado la primera versión de la especificación para su uso sobre HTTP, un documento complementario que establece estándares para mejorar la interoperabilidad y la observabilidad de los servicios. Esta iniciativa resuelve una limitación histórica de la especificación principal, que ha sido agnóstica del transporte, al definir cómo deben enviarse y recibirse las peticiones y respuestas en entornos web estándar.

El cambio más significativo es la introducción de un nuevo tipo de medio, application/graphql-response+json, que permite a los clientes distinguir entre respuestas válidas del servidor y errores de proxies o cachés, eliminando la confusión generada por el uso de códigos de estado 200 para errores. La especificación detalla la guía para el uso de códigos de estado HTTP, como el 422 para errores de procesamiento o el 294 para éxito parcial, asegurando que el estado de la solicitud refleje la realidad técnica del servidor.

Además, el documento documenta los fundamentos técnicos actuales, incluyendo la codificación JSON, cabeceras y métodos GET/POST. El equipo de desarrollo planea integrar el verbo HTTP QUERY, propuesto por el IETF, y estandarizar las consultas persistentes y el agrupamiento de peticiones, áreas donde la falta de un estándar ha limitado la eficiencia y la seguridad. La adopción de esta especificación ya está presente en la mayoría de los frameworks y bibliotecas existentes, facilitando una transición suave para los desarrolladores.