Mandatory.

The Host header defines Carriots REST API server (where to connect). More details at http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.23

Value: api.carriots.com

Example: Host: api.carriots.com

Mandatory.

This header defines the request API key. This apikey will be used to fully determine privileges and visibility for the request within Carriots platform.
Example: carriots.apiKey: ed5620c5013d782fe2eeaf9fd03b7fc0a42fafb06f0608b58d5ab2f9027f955f

Mandatory.

Defines expected request MIME type. Carriots currently accepts 4 different MIME types:

• application/json: Carriots will render the response in JSON format following the current REST API specifications
• application/xml: Carriots will render the response in XML format following the current REST API specifications
• application/vnd.carriots.v2+json: Carriots will render the response in JSON format following the version 2 REST API specifications
• application/vnd.carriots.v2+xml: Carriots will render the response in XML format following the version 2 REST API specifications

Notes:

• Default value: application/vnd.carriots.v2
• If no Accept header is present, Carriots will assume the default value
• If no version is defined, Carriots will assume the most recent version available
• If Carriots do not understand the Accept header value, default value will be assumed and no error will be returned
• Several values may be defined separated by commas with priority specified by ;q=
• More details at http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.1

Examples:

Accept: application/vnd.carriots.v2 ? default (API v2 and JSON format)
Accept: application/vnd.carriots.v2+xml ? API v2 and XML format
Accept: application/vnd.carriots ? most recent API and JSON format
Accept: application/vnd.carriots+xml ? most recent API and XML format
Accept: application/json;q=0.9,vnd.carriots,application/xml;q=0.8

Mandatory.

Defines client software. More details at http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.43

Example: User-Agent: device A001

Mandatory.

Defines bodys data length in bytes. More details at http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13

Example: Content-Length: 209

Mandatory.

Defines expected request MIME type. Carriots currently accepts 4 different MIME types:

• application/json: Carriots will render the response in JSON format following the current REST API specifications
• application/xml: Carriots will render the response in XML format following the current REST API specifications
• application/vnd.carriots.v2+json: Carriots will render the response in JSON format following the version 2 REST API specifications
• application/vnd.carriots.v2+xml: Carriots will render the response in JSON format following the version 2 REST API specifications

Notes:

• Default value: application/vnd.carriots.v2+json
• If no Content-Type header is present, Carriots will assume default value
• If no version is defined, Carriots will assume the most recent version available
• If Carriots do not understand the Content-Type header value, default value will be assumed and no error will be returned
• More details at http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17

Example: Content-Type: application/vnd.carriots.v2+xml

Defines message response date and hour. More details at http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.18

Holds information about request software used by the server. Default value: Carriots REST API

List of allowed actions for the given resource. More details at http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.7

Defines connection options for the sender.
Carriots always closes connection after the response.

Defines the directives for cache management. More details at: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9

Defines bodys data length in bytes. More details at http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13

Defines response body MIME type. More details at http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17