Repository files navigation

Stage 2: Draft

This spec is in the draft stage of development, and can change before reachingAccepted stage. For more information, please see theRoadmaporhow to get involved.

You can find our community in thegraphql-over-http channelon theGraphQL Foundation Discord.

Introduction

HTTP is the most common choice as the client-server protocol when using GraphQLbecause of its ubiquity. However theGraphQL specification deliberatelydoes not specify the transport layer.

The closest thing to an official specification is the articleServing over HTTP. Leadingimplementations on both client and server have mostly upheld those bestpractices and thus established a de-facto standard that is commonly usedthroughout the ecosystem.

This specification is intended to fill this gap by specifying how GraphQL shouldbe served over HTTP. The main intention of this specification is to provideinteroperability between different client libraries, tools and serverimplementations.

Spec Location

The GraphQL over HTTP specification is edited in thespec-md markdown file.

In the future, we plan that you would be able to view the generated form of thespecification as well.

This repository is managed by EasyCLA. Project participants must sign the free(GraphQL Specification Membership agreementbefore making a contribution. You only need to do this one time, and it can besigned byindividual contributors ortheiremployers.

To initiate the signature process please open a PR against this repo. TheEasyCLA bot will block the merge if we still need a membership agreement fromyou.

You can finddetailed information here.If you have issues, please emailoperations@graphql.org.

If your company benefits from GraphQL and you would like to provide essentialfinancial support for the systems and people that power our community, pleasealso consider membership in theGraphQL Foundation.

Copyright Joint Development Foundation Projects, LLC, GraphQL Series.
graphql.org |Spec |GitHub |GraphQL Foundation |Code of Conduct |Discord |Store