Content negociation and media types

How to describe your API data format and/or propose different formats (like json, yaml, xml atom, …)

Agenzia per l'Italia Digital & Team per la trasformazione digital (Italian administration) - Interoperability model for the Public Administration

REST interface processing rules

Avoid custom Content-Types

Formats

API Payload format encoding

3.3 Representations

3.5.1 Standard Headers

Accept header, Content-Type header

Content type negotiation

Versioning

Protocol Buffers v3

It supports both binary and text wire formats, and works with many different wire protocols on different platforms.

Standard request headers

Accept Content Type

Standard response headers

Content Type

Clients-specified response format

Representations

Content-Types

General guidelines for RESTful URLs

Formats should be in the form of api/v2/resource/{id}.json

Use Media Type Versioning

Use Application-Specific Content Types

Content Negociation