Опубликован рабочий черновик спецификации 'GraphQL over HTTP' (24 июля 2025 года)

Основное обновление

Опубликован рабочий черновик спецификации GraphQL over HTTP (рабочий черновик от 24 июля 2025 года), который формально определяет, как кодировать запросы и ответы GraphQL по протоколу HTTP — включая новый тип медиа для ответов (application/graphql-response+json), канонические имена параметров запроса, рекомендуемые шаблоны URL (например, /graphql) и четкие рекомендации по семантике кодов состояния HTTP для ответов GraphQL. (graphql.github.io)

Почему это важно

Этот черновик переводит экосистему от де-факто соглашений к явному, совместимому контракту. На практике спецификация позволяет серверам и клиентам согласовывать, когда код состояния, отличный от 2xx, имеет значение (спецификация вводит специальный тип медиа, чтобы посредники и инструменты могли доверять кодам состояния HTTP), предписывает формы запросов/ответов и согласование контента, а также рекомендует поведение URL и кэширования — все это напрямую влияет на реализации серверов, клиентские библиотеки, прокси, CDN и инструменты наблюдаемости. (graphql.github.io)

Для разработчиков, которые запускают или интегрируют службы GraphQL: вам следует запланировать (a) добавление поддержки нового типа медиа наряду с application/json, (b) аудит посредников (обратные прокси, CDN, API-шлюзы), чтобы убедиться, что они не переписывают или не удаляют ответы GraphQL, и (c) обновление клиентских библиотек и серверных фреймворков в соответствии с рекомендациями спецификации по параметрам запроса и URL для улучшения кэширования, семантики ошибок и совместимости инструментов. Спецификация все еще является черновиком, но ее рекомендации уже достаточно точны, чтобы инициировать конкретные изменения совместимости и развертывания. (github.com)

Источник

• Источник