@@ -15,20 +15,20 @@ A GraphQL service generates a response from a request via execution.
15
15
being executed. Conceptually, an initial value represents the "universe" of
16
16
data available via a GraphQL Service. It is common for a GraphQL Service to
17
17
always use the same initial value for every request.
18
- - {extensions} (optional): A map reserved for implementers to extend the
19
- protocol however they see fit.
20
-
21
- Note: Since future versions of the specification may add more information,
22
- implementers should not extend requests directly; instead, {extensions} provides
23
- a reserved location for implementers to include additional information. If
24
- present, {extensions} must be a map, but there are no additional restrictions on
25
- its contents. To avoid conflicts, we recommended implementers use unique
26
- prefixes for keys within {extensions}.
18
+ - {extensions} (optional): A map reserved for implementation-specific additional
19
+ information.
27
20
28
21
Given this information, the result of {ExecuteRequest(schema, document,
29
22
operationName, variableValues, initialValue)} produces the response, to be
30
23
formatted according to the Response section below.
31
24
25
+ Implementations should not add additional properties to a _ request_ , which may
26
+ conflict with future editions of the GraphQL specification. Instead,
27
+ {extensions} provides a reserved location for implementation-specific additional
28
+ information. If present, {extensions} must be a map, but there are no additional
29
+ restrictions on its contents. To avoid conflicts, keys should use unique
30
+ prefixes.
31
+
32
32
Note: GraphQL requests do not require any specific serialization format or
33
33
transport mechanism. Message serialization and transport mechanisms should be
34
34
chosen by the implementing service.
0 commit comments