diff --git a/_format/1.0/index.md b/_format/1.0/index.md index 9c909d1ef..08469236d 100644 --- 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 index ab3ba0bd0..065dae1f0 100644 --- a/_format/1.1/index.md +++ b/_format/1.1/index.md @@ -1151,11 +1151,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 pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy