Common REST Headers

Most REST calls require extra HTTP headers. The most common headers used by Doradus are:

•	Content-Type: Describes the MIME type of the input entity, optionally with a Charset parameter. The MIME types supported by Doradus are text/xml (the default) and application/json.

•	Content-Length: Identifies the length of the input entity in bytes. The input entity cannot be longer than max_request_size, defined in the doradus.yaml file.

•	Accept: Indicates the desired MIME type of an output (response) entity. If no Accept header is provided, it defaults to input entity’s MIME type, or text/xml if there is no input entity.

•	Content-Encoding: Specifies that the input entity is compressed. Only Content-Encoding: gzip is supported.

•	Accept-Encoding: Requests the output entity to be compressed. Only Accept-Encoding: gzip is supported. When Doradus compresses the output entity, the response includes the header Content‑Encoding: gzip.

•	X-API-Version: Requests a specific API version for the command. Currently, X-API-Version: 2 is supported.

•	Authorization: This header is used to provide credentials when required, e.g., when Doradus is operating in multi-tenant mode and the command is directed to a specific tenant. Multi-tenant operation is described later.

Header names and values are case-insensitive.