Skip to content

Commit 7dd73e7

Browse files
authored
Define request, note it is transport independent (#949)
1 parent 84ec339 commit 7dd73e7

4 files changed

+8
-4
lines changed

Diff for: spec/Section 1 -- Overview.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ GraphQL is a query language designed to build client applications by providing
44
an intuitive and flexible syntax and system for describing their data
55
requirements and interactions.
66

7-
For example, this GraphQL request will receive the name of the user with id 4
7+
For example, this GraphQL _request_ will receive the name of the user with id 4
88
from the Facebook implementation of GraphQL.
99

1010
```graphql example

Diff for: spec/Section 2 -- Language.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Language
22

33
Clients use the GraphQL query language to make requests to a GraphQL service. We
4-
refer to these request sources as documents. A document may contain operations
4+
refer to these _request_ sources as documents. A document may contain operations
55
(queries, mutations, and subscriptions) as well as fragments, a common unit of
66
composition allowing for data requirement reuse.
77

Diff for: spec/Section 6 -- Execution.md

+5-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
GraphQL generates a response from a request via execution.
44

5-
A request for execution consists of a few pieces of information:
5+
:: A _request_ for execution consists of a few pieces of information:
66

77
- The schema to use, typically solely provided by the GraphQL service.
88
- A {Document} which must contain GraphQL {OperationDefinition} and may contain
@@ -17,6 +17,10 @@ A request for execution consists of a few pieces of information:
1717
Given this information, the result of {ExecuteRequest()} produces the response,
1818
to be formatted according to the Response section below.
1919

20+
Note: GraphQL requests do not require any specific serialization format or
21+
transport mechanism. Message serialization and transport mechanisms should be
22+
chosen by the implementing service.
23+
2024
## Executing Requests
2125

2226
To execute a request, the executor must have a parsed {Document} and a selected

Diff for: spec/Section 7 -- Response.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Response
22

3-
When a GraphQL service receives a request, it must return a well-formed
3+
When a GraphQL service receives a _request_, it must return a well-formed
44
response. The service's response describes the result of executing the requested
55
operation if successful, and describes any errors raised during the request.
66

0 commit comments

Comments
 (0)