Le blog

Memex - La route du REST

Publié le 13 octobre 2020

Au détour de mes formations, workshops, et discussions, même parmi les plus érudits d'entre nous, j'ai pu constater qu'il y avait des pans entiers de l'architecture REST qui avaient été éludés pendant les phases d'études. Par manque de temps parfois, par manque d'accompagnement souvent, par manque d'accès à l'information surtout. Il existe trop peu de lectures françaises autour de la construction d'APIs REST. Il existe quelques articles ici et là sur Internet, mais la plupart ne couvrent que certains aspects. Les contenus les plus importants incluant REST dans son intégralité ainsi que la conception du web et d'Internet, ne sont pas légion, et surtout sont en anglais. Ce qui peut être un véritable frein à la connaissance. En préparant les formations pour API Platform, et en les donnant, jour après jour et mois après mois, une liste de points liés au web, si nécessaires à la bonne compréhension et utilisation du framework, s'est dessinée peu à peu dans ma tête.

J'ai donc décidé qu'il y aurait à présent un livre écrit en français, à mi-chemin entre la technique et l'histoire. Comme un manuel indispensable pour bien débuter et consolider sa vision du web avant de commencer à développer des outils, des APIs, des sites internet. Un livre que l'on pourrait recommander au lycée ou à l'université. Voilà mes ambitions début mars.

J'ai ensuite passé 4 mois à rassembler mes idées, les coucher sur le papier, les faire relire par des pairs, réarranger le tout, créer les schémas en vectoriel. J'étais très content du résultat, mais je ne réalisais pas encore que j'étais seulement à mi-chemin. J'ai continué à retoucher le texte et la mise en page pendant près de 2 mois et demi, puis un nouveau mois de correction grammaticale, orthographique et syntaxique. Maintenant, il faut pouvoir imprimer, publier et promouvoir le livre !

Pour l'impression, j'ai d'abord cherché local mais je n'ai pas su trouver mon bonheur. C'est en me renseignant sur l'autopublication que j'ai trouvé le bon imprimeur. C'est un imprimeur français (pumbo.fr) qui permet d'imprimer en offset, stocker et expédier, tout comme il permet l'impression à la demande, et ça c'était important pour moi. Je voulais que le livre soit toujours disponible.

Pour publier un livre, il faut un éditeur. Il en existe quelques-uns dans le paysage français, mais ils ont chacun leur ligne éditoriale, il m'aurait été difficile de me plier à leur mise en page, et leurs exigences certainement différentes des miennes. Je n'étais pas non plus certains des prix qui seraient pratiqués et puis, soyons honnêtes, je n'étais pas convaincu que l'inconnu que je suis les intéresse et qu'ils acceptent de me publier. J'ai donc fini par me lancer dans l'auto-édition. Cela signifie que je devais faire plusieurs choses : créer et enregistrer mon entreprise à la chambre de commerce, acheter des codes ISBN pour le format papier, le format PDF (et je vais probablement devoir en acheter un nouveau pour le format Epub), enfin, enregistrer le livre auprès de la Bibliothèque Nationale de France et lui envoyer un exemplaire.

memexDernière étape, la promotion. Le visuel et l'audiovisuel prennent une part très importante dans la communication. J'ai dû me former à la vidéo, le montage, l'étalonnage, la lumière, la prise de son. Tout ceci prend énormément de temps et demande un peu d'investissement.

C'est pour cette raison que pour le lancement du livre, j'ai choisi de lancer une campagne participative. Sans elle, la première impression ne serait pas possible. Vous la trouverez ici :

Je compte sur vous pour exploser le compteur des commandes et j'espère que ce livre vous plaira autant que j'ai eu de plaisir à l'écrire !

À qui est destiné ce livre ?

Ce livre est destiné aux personnes qui souhaitent en apprendre un peu plus sur le fonctionnement d'internet, les origines du web, de REST, et des concepts établis qui font le web d'aujourd'hui. Il est aussi destiné aux développeuses et développeurs d'API qui souhaitent en apprendre plus sur les standards et la philosophie derrière REST, qu'ils aient pour objectif de créer une API REST, de zéro, ou avec un framework comme API Platform.

Ce livre exprime une partie du travail de Roy Fielding et Tim Berners-Lee sur le sujet. Il vous guidera vers une meilleure compréhension, une meilleure implémentation et un meilleur respect de leur vision. Rappelons qu'ils sont à l'origine du web que nous exploitons et enrichissons, mais qu'en voyant ce que nous en faisons, ils sont déçus. Enfin, cet ouvrage vous guidera à travers l'histoire du World Wide Web et de REST. Les innombrables articles présents sur internet (Wikipédia inclus) ne sont pas suffisants pour connaitre l'intégralité des tenants et aboutissants de REST et du Web.

Une fois que vous aurez terminé ce livre et que vous aurez compris les différents rouages, prenez le temps de lire leurs travaux afin de devenir vous-même un expert sur le sujet.

Grégoire Hébert

Grégoire Hébert

Principal developer

Mots-clésAPI, HTTP, Hypermedia, REST, Web

Le blog

Pour aller plus loin