To retrieve a single resource, perform an HTTP GET on the resource by its case-sensitive identifier (
_id) and accept a JSON response:
GET /users/some-id HTTP/1.1 Host: example.com Accept: application/json
You can use the following parameters:
Format the body of the response.
Return only the specified fields in the body of the response.
fieldvalues are JSON pointers. For example if the resource is
parent/childrefers to the
fieldis left blank, the server returns all default values.
Some resources have fields whose values are multi-media resources such as a profile photo for example.
If the feature is enabled for the endpoint, you can read a single field that is a multi-media resource by specifying the field and mime-type.
In this case, the content type of the field value returned matches the mime-type that you specify, and the body of the response is the multi-media resource.
Acceptheader is not used in this case. For example,
Accept: image/pngdoes not work. Use the
_mimeTypequery string parameter instead.