Building Hypermedia APIs with HTML5 and Node

Review

Hypermedia est souvent considéré comme l’élément clé des services REST, mais en regardant les APIs existantes, on ne peut dire que cela soit si évident. Cette notion tellement facile à comprendre quand il s’agit du Human Web avec les fameux hyperlinks, est pourtant la clé pour des APIs maintenables et évolutives dans le temps.

Mike Amundsen, la référence sur le sujet, nous livre un livre exclusivement tourné sur le sujet et très orienté pratique puisque l’essentiel du livre est composé de cas d’études. Mention spéciale pour le premier chapitre qui synthétise à merveille la notion d’hypermedia, à travers plusieurs classifications (les H-Factors, les Media Types, …). Le dernier chapitre, moins percutant, est lui consacré à la documentation des Media Type et de leurs relations.

La présence des termes HTML5 et Node dans le titre m’avait refroidi, craignant un livre qui surfe sur les buzzwords mais il en est tout autre. Ces technologies ne sont utilisées que par facilité lors des exemples de manière à avoir un code concis et clair. Elles ne sont d’ailleurs pas introduites, ce qui pourra dérouter un peu le lecteur qui découvre Node.js et Express pour la première fois. Rien d’insurmontable toutefois, d’autant plus que les idées pourront être retranscrites dans le langage de votre choix sans aucun problème.

On regrettera des codes exemples mal formatés avec quelques erreurs de syntaxe. Regrettable pour un livre si court.

Building Hypermedia APIs with HTML5 and Node n’est définitivement pas le livre à livre pour découvrir les services REST. Trop ciblé, d’autres livres comme le classique RESTFul Web Services reste toujours aussi incontournable même ans après sa parution, tant l’évolution annoncée décrite par Mike Amundsen se fait attendre… (On peut retracer la notion d’hypermedia dès 2001 dans la thèse de Roy T. Fielding avec l’acronyme épouvantable HATEOAS !)