Media Type

Le Media Type habituel défini avec le header Content-Type est application/json.

Il est courant de définir un Media Type spécifique pour une API ou éventuellement en fonction du standard utilisé. Exemple : application/vnd.github+json.

Les Media Type de type application/vnd* ne sont pas standards et peuvent éventuellement poser des problèmes avec certaines librairies ou connecteurs (Ex.: Web Application Firewall).

Certains s’amusent à retourner un contenu HTML (présentation, documentation, démo etc…) lorsque le client ne présente pas le bon Media Type dans le header Accept.

C’est élégant…

…mais pas pratique du tout ! Qui n’a jamais testé une URL d’API ReST sur son browser ?