API Guidelines
Comment on page

Message Formats

Response Message Format

All response messages MUST support an application/hal+json (HAL) format.

Error Response Format

The application/problem+json (Problem Detail) MUST be used to communicate details about an error.

Request Message Format

Request messages with body SHOULD support a application/json (JSON) format. Where applicable, request message SHOULD also support the application/hal+json format.
Request messages MAY also support the application/x-www-form-urlencoded (URL Encoded) format.