发布了'HTTP上的GraphQL'规范的工作草案（2025年7月24日）

关键更新

发布了HTTP上GraphQL规范的工作草案（工作草案日期为2025年7月24日），正式定义了如何通过HTTP编码GraphQL请求和响应——包括一种新的响应媒体类型（application/graphql-response+json）、规范的请求参数名称、推荐的URL模式（例如，/graphql）以及关于GraphQL响应的HTTP状态码语义的明确指导。（graphql.github.io）

重要性

该草案将生态系统从事实上的惯例转变为明确的、可互操作的合同。实际上，该规范使服务器和客户端能够就何时非2xx状态码有意义达成一致（该规范引入了一种专用的媒体类型，以便中介和工具可以信任HTTP状态码），规定了请求/响应的形状和内容协商，并推荐了URL和缓存行为——所有这些都直接影响服务器实现、客户端库、代理、CDN和可观察性工具。（graphql.github.io）

对于运行或集成GraphQL服务的开发者：您应该计划（a）在application/json旁边添加对新媒体类型的支持，（b）审计中介（反向代理、CDN、API网关），以确保它们不会重写或丢弃GraphQL响应，以及（c）更新客户端库和服务器框架，以遵循规范的请求参数和URL指导，以改善缓存、错误语义和工具互操作性。该规范仍然是草案，但其建议已经足够精确，可以推动具体的兼容性和部署变更。（github.com）

来源

• 来源