SnowCamp 2023

Ce talk présente des principes/recommandations pour concevoir des URLs d'une API REST. Au travers du nommage, c'est la conception même de votre API qui est exposée.
En appliquant ces principes, vous d'améliorerez la DX (Developer eXperience) lors de l'utilisation de votre API en maximisant l'affordance (Evitez le RTFM ou comment minimisez la doc parce que de toute façon, le developer ne l'a lit pas ...).

Le contenu :
- Introduction : Pourquoi se soucier du nommage dans une API?
- Resource vs fonction : Avoir une approche ressource dans le nommage de son API: Pourquoi et Comment ?
- Granularité d'API : C'est quoi la bonne taille ... de votre ressource.
- Nommage : tiret, undescore ... ou Camel case ? mais aussi le choix des mots et KISS
- Versioning : Quand et comment
- Tri, Filtre, Recherche : Eviter le NIH (Not Invented Here) en utilisant les conventions bien établies
- Gestion des erreurs : Et si on repartait déjà de HTTP

Je présente aussi ce que font les géants du web et on verra qu'ils ne sont toujours d'accord entre eux.

A la fin vous aurez les clés pour construire une API qui respecte la philosophie REST et qui soit facilement compréhensible par les développeurs.