Cet article propose des pistes pour concevoir une API REST dans le cas où CRUD ne suffit plus.

L'article revient sur la définition de la notion de Ressource et des Verbes et de leur utilité. Il nous propose d'aller au delà de ces concepts basiques (www.restapitutorial.com/....

L'auteur nous invite à partir en quête bon niveau de granularité afin de modéliser les ressources REST pour des domaines plus complexes et exigeants.

Entre une API trop bas niveau qui devient très "chatty" pour ses clients et une API conçue pour répondre à tous les cas d'utilisation des clients au risque d'en devenir un cauchemard à maintenir.

REST API Design - Resource Modeling

1. Fine grained CRUD resources versus Coarse Grained resources
1.1. Preventing migration of business logic to API consumer
2. Coarse grained aggregate resources for business processes
2.1. Escaping CRUD
2.2. Nouns versus Verbs
2.3. Reification of abstract concept
2.4. REST without PUT and CQRS
2.5. An example from the public GitHub API
3. On a closing note

Bonus, sur un sujet annexe :
www.joelonsoftware.com/...

Partagé par Marc Bouvier

il y a environ 5 ans

5

Ludovic Dine il y a environ 5 ans

Ton article m'intéresse beaucoup ! J'avais fait une API Rest complète avec Node.js pour un projet il y a 3 ans, et j'envisageais de me rafraîchir les idées sur le sujet.

0

Marc Bouvier il y a environ 5 ans - modifié il y a environ 5 ans

Il y a aussi les articles d'octo que je trouve bien faits et en français.

- Designer une API REST : blog.octo.com/...
- Sécuriser une API REST : blog.octo.com/...
- Concevoir une API REST conforme au RGPD : blog.octo.com/...

0

Pour ajouter un commentaire, tu dois te connecter ou créer un compte.