Concevoir une API REST

Aujourd'hui, la plupart des usages numériques (lire ses mails, poster du contenu, utiliser une IA...

HTTP (HyperText Transfer Protocol) est le protocole du web. Le principe est simple : un client en...

API signifie Application Programming Interface : une interface qui permet à un programme d'utilis...

REST n'est pas la seule façon de construire une API. Voici les principales, avec le même besoin à...

Objectif Beaucoup de sites modernes sont des SPA : le navigateur charge une page quasi vide, pui...

REST (REpresentational State Transfer) n'est ni un protocole ni une norme : c'est un style d'arch...

Les ressources Une ressource est tout ce qui mérite d'avoir un nom et une adresse : un utilisate...

Les verbes (ou méthodes) HTTP indiquent l'action à effectuer sur la ressource désignée par l'URI....

Le code de statut est la première chose qu'un client regarde. Un bon code évite au client de devo...

En 2008, Leonard Richardson propose un modèle en 4 niveaux pour mesurer à quel point une API expl...

Tout au long de ce cours, nous allons fréquenter un établissement très particulier : API-ritif, l...

Pour parler à une API, pas besoin d'écrire du code : des outils permettent d'envoyer des requêtes...

Objectif Le barman d'API-ritif a caché un trésor quelque part dans son API. Pour le trouver, il ...

curl et Bruno, c'est bien pour explorer. Mais pour automatiser, il faut appeler l'API depuis du c...

Un script qui marche sur la première page, avec un serveur de bonne humeur, c'est facile. Un scri...

Jusqu'ici, les clients de nos API étaient des programmes écrits par des humains. Depuis l'arrivée...

Objectif Pendant la chasse au trésor, toute la promo a passé des commandes au bar. Le patron d'AP...

Une URL est la première chose qu'un développeur voit de votre API. Si elle est claire, il devine ...

Une collection peut contenir des milliers d'éléments. Le client doit pouvoir n'en demander qu'une...

Une API publiée a des clients que vous ne connaissez pas : des applications mobiles qui ne seront...

Le code de statut dit qu'il y a une erreur. Le body doit dire laquelle, et comment la corriger. P...

Objectif En rangeant la réserve du bar, le patron d'API-ritif a retrouvé une clé USB étiquetée « ...

Pendant la chasse au trésor, vous avez découvert API-ritif à tâtons, en lisant les réponses une p...

YAML en 30 secondes YAML est un format de données lisible, basé sur l'indentation (des espaces, j...

Le contrat et le code doivent dire la même chose. Mais lequel écrit-on en premier ? Code-first O...

Un contrat en YAML, c'est précis mais austère. Des outils le transforment en une documentation ag...

Un contrat OpenAPI est lisible par les machines. Elles peuvent donc écrire à votre place le code ...

Assez consommé : passons derrière le comptoir. Dans ce chapitre, on construit une API en Python a...

On construit une mini carte de cocktails, stockée en mémoire. Elle disparaît au redémarrage du se...

À la page précédente, FastAPI refusait déjà un prix en lettres ou un nom manquant, mais avec son ...

Objectif Le patron d'API-ritif veut recueillir l'avis de ses clients. Le contrat est déjà écrit (...

Persister les données avec SQLite Nos données en mémoire disparaissent à chaque redémarrage. SQLi...

Authentification ou autorisation ? Authentification : qui es-tu ? L'échec donne un 401 Unauthori...

HTTPS : non négociable En HTTP, tout circule en clair : l'URL, les headers, le body. Sur le Wi-Fi...

Une API sans limite finit toujours par recevoir trop de requêtes : un script en boucle infinie, u...

L'OWASP (Open Worldwide Application Security Project) est une fondation qui publie des références...

Objectif Le barman d'API-ritif a laissé passer deux failles de l'OWASP Top 10 dans son API. À vou...

Le cache HTTP avec ETag Pourquoi retélécharger la carte si elle n'a pas changé ? Le serveur assoc...

Sur un site web, vous ne tapez jamais d'URL à la main : vous arrivez sur la page d'accueil et vou...

REST dit qu'il faut des liens, mais pas comment les écrire. Plusieurs formats se sont imposés. Vo...

C'est là que HATEOAS devient vraiment utile : les liens ne décrivent pas seulement les ressources...

Fielding le répète depuis 2008 : sans hypermédia, ce n'est pas REST. Pourtant, la grande majorité...