Merge pull request json-api#1500 from freddrake/default-fields-may-be-subset

dgeb · web-flow · commit 1a571802efdc · 2020-08-07T15:56:50.000-04:00
state that the server may send a subset of fields by default
diff --git a/_format/1.0/index.md b/_format/1.0/index.md
@@ -1000,11 +1000,16 @@ response on a per-type basis by including a `fields[TYPE]` parameter.
 
 The value of the `fields` parameter **MUST** be a comma-separated (U+002C
 COMMA, ",") list that refers to the name(s) of the fields to be returned.
+An empty value indicates that no fields should be returned.
 
 If a client requests a restricted set of [fields] for a given resource type,
 an endpoint **MUST NOT** include additional [fields] in resource objects of
 that type in its response.
 
+If a client does not specify the set of [fields] for a given resource type,
+the server **MAY** send all fields, a subset of fields, or no fields for that
+resource type.
+
 ```http
 GET /articles?include=author&fields[articles]=title,body&fields[people]=name HTTP/1.1
 Accept: application/vnd.api+json
diff --git a/_format/1.1/index.md b/_format/1.1/index.md
@@ -1322,11 +1322,16 @@ response on a per-type basis by including a `fields[TYPE]` query parameter.
 
 The value of any `fields[TYPE]` parameter **MUST** be a comma-separated (U+002C
 COMMA, ",") list that refers to the name(s) of the fields to be returned.
+An empty value indicates that no fields should be returned.
 
 If a client requests a restricted set of [fields] for a given resource type,
 an endpoint **MUST NOT** include additional [fields] in resource objects of
 that type in its response.
 
+If a client does not specify the set of [fields] for a given resource type, the
+server **MAY** send all fields, a subset of fields, or no fields for that
+resource type.
+
 ```http
 GET /articles?include=author&fields[articles]=title,body&fields[people]=name HTTP/1.1
 Accept: application/vnd.api+json
