Le comité technique de GraphQL a publié coup sur coup, les 12 et 13 novembre 2026, une nouvelle édition de la spécification du langage et le tout premier texte officiel qui encadre son transport sur HTTP : deux documents qui touchent directement les équipes qui exposent ou consomment des API GraphQL.
- La spécification GraphQL September 2026 est en ligne depuis le 13 novembre, un an après l’édition 2025.
- Elle accepte les sélections vides, autorise des directives sur les définitions de directives et resserre la validation de
@oneOf. - La spécification GraphQL over HTTP, publiée le 12 novembre, fixe enfin les règles de GET, POST, des codes de statut et du type
application/graphql-response+json. - Le batching, les documents persistés et la méthode HTTP QUERY sont renvoyés aux prochaines révisions.
Plan de l'article
Pourquoi cette édition 2026 compte-t-elle pour les développeurs ? #
Pendant des années, la spécification de GraphQL a peu bougé. L’édition de septembre 2025, celle qui a introduit les objets d’entrée @oneOf, était la première depuis quatre ans. Le comité technique (TSC) explique désormais viser un rythme proche de l’annuel, et l’édition September 2026 est la première à respecter ce calendrier.
À lire Tim Peters, auteur du Zen of Python et de Timsort, est mort : ce que lui doit le langage
Pour une équipe, c’est un changement d’habitude. Les évolutions du langage arrivent par petites touches régulières plutôt que par grands sauts. Il devient raisonnable de suivre les notes de version de sa bibliothèque serveur comme on suit celles de son framework front.
Que change concrètement la spécification September 2026 ? #
L’annonce publiée sur le blog officiel de GraphQL détaille quatre évolutions. Aucune ne casse une API existante, mais deux d’entre elles demanderont une mise à jour des serveurs.
Les sélections vides deviennent valides
Une requête réduite à {} est désormais acceptée par un serveur conforme. Jusqu’ici, la plus petite requête valable partout était {__typename}. Le besoin vient des champs purement locaux côté client, comme ceux marqués par une directive de type @mock : une fois retirés avant l’envoi, ils pouvaient laisser une sélection vide qui faisait échouer la validation.
Des directives sur les directives
Un nouvel emplacement, DIRECTIVE_DEFINITION, permet d’appliquer une directive à la définition d’une autre directive. L’usage le plus parlant est de marquer une directive personnalisée comme @deprecated, avec une raison, pour accompagner sa disparition. Les cycles restent interdits.
À lire Index TIOBE de novembre 2026 : Dart entre dans le top 20, Java repasse devant C++
Une définition plus juste des fragments
Le texte ne présente plus les fragments comme un simple moyen d’éviter la répétition. Il recommande que chaque composant d’une application cliente déclare ses besoins en données dans son propre fragment, puis que ces fragments soient composés pour former l’opération envoyée au serveur. C’est la pratique popularisée par Relay, désormais écrite noir sur blanc.
Une validation plus stricte de @oneOf
La validation du schéma rejette maintenant les objets d’entrée @oneOf impossibles à satisfaire, par exemple un type dont l’unique champ pointe vers lui-même. Un schéma qui contenait ce genre de construction, souvent par erreur, sera signalé comme invalide par les implémentations à jour.
Que fixe la nouvelle spécification GraphQL over HTTP ? #
Le langage GraphQL a toujours été indépendant du transport. Dans les faits, presque tout passe par HTTP, avec des conventions qui variaient d’un serveur à l’autre. L’annonce du 12 novembre présente un document séparé, qui ne modifie pas la spécification principale et dont la première version officielle porte, elle aussi, le nom September 2026.
Le texte couvre l’URL, les requêtes GET et POST, l’encodage JSON et les en-têtes. Une mutation envoyée en GET doit être refusée avec un code 405. Un type de média demandé mais non pris en charge appelle un 406, un type fourni non pris en charge un 415.
À lire PowerShell 7.7 est sorti : 7.4 et 7.5 ne sont plus supportées, quelle version choisir
La règle générale des codes de statut tient en une phrase : si la requête a renvoyé des données, le serveur répond en 2xx, si elle n’a renvoyé que des erreurs, il répond en 4xx ou 5xx. C’est une rupture avec l’habitude du « 200 pour tout », qui obligeait les clients et les outils de supervision à lire le corps de la réponse pour savoir si l’appel avait échoué.
Le rôle du type application/graphql-response+json
Le nouveau type de média application/graphql-response+json garantit au client que le corps est une réponse GraphQL bien formée, quel que soit le code de statut. Un client conforme doit l’indiquer dans son en-tête Accept. Les clients qui ne l’envoient pas sont qualifiés de clients historiques dans le texte, ce qui laisse aux serveurs une marge de compatibilité.
Faut-il migrer ses API dès maintenant ? #
Selon le comité, la plupart des frameworks et bibliothèques GraphQL suivent déjà ces règles, souvent sans que leurs utilisateurs le sachent, puisque le brouillon était largement adopté. Le premier réflexe consiste donc à vérifier la version de son serveur et sa documentation, plutôt qu’à réécrire quoi que ce soit.
Trois points méritent un test rapide : la réponse à une mutation envoyée en GET, le type de média renvoyé, et le code de statut d’une requête qui échoue à la validation. Côté client, il faut s’assurer que la logique d’erreur ne suppose plus un 200 systématique, sous peine de traiter un 4xx comme une panne réseau.
À lire Fin de support de .NET 8 et .NET 9 : pourquoi viser .NET 10 ou .NET 11 dès maintenant
Plusieurs sujets attendent encore. La méthode HTTP QUERY, en cours de normalisation à l’IETF, est prévue pour la prochaine révision. Les documents persistés et le regroupement de requêtes (batching), utile aux schémas fédérés, sont en cours de travail.
Questions fréquentes #
Une API GraphQL existante cesse-t-elle de fonctionner avec l’édition 2026 ?
Non. Les nouveautés élargissent ce qui est accepté, à l’exception des schémas contenant un @oneOf impossible à satisfaire, qui seront désormais refusés à la validation.
Où lire le texte complet ?
La spécification du langage est publiée sur spec.graphql.org, celle du transport sur http-spec.graphql.org, chacune dans son édition September 2026.
Comment signaler un problème dans la spécification HTTP ?
Le comité invite les auteurs de bibliothèques à l’adopter et à remonter leurs retours sous forme de tickets sur le dépôt GitHub graphql-over-http.
À lire VS Code 1.145 : agents distants, revue croisée entre agents et automatisations cron




