9. Conclusion

Avec les quatre opérations CRUD que nous avons mis en place dans nos points de terminaisons, vous êtes maintenant capable de réaliser n’importe quel projet d’API Rest. Et oui, toutes les applications que vous utilisez quotidiennement sont basées sur ces opérations, et pas une de plus.

Cependant, malgré une simplicité apparente, nous avons vu qu’il fallait être attentif sur plusieurs points, comme c’était le cas pour les opérations de modification ou de suppression. Ou encore le fait de parser les données entrantes dans notre API Rest afin d’obtenir des données au format JSON.

Bref, maintenant que nous maîtrisons les bases, nous allons pouvoir poursuivre le développement de notre API Rest par-dessus, et c’est le plus important. Doucement, mais surement !

En résumé

  • Les opérations dites « CRUD » correspondent à la création d’une ressource, sa récupération, sa modification et enfin sa suppression.
  • Pour effectuer des requêtes différentes du type GET, nous devons installer un outil spécialisé comme Insomnia.
  • Malgré une apparente simplicité, la mise en place des opérations CRUD recèle quelques subtilités qu’il faut savoir remarquer.
  • Pour le endpoint de création d’une ressource, c’est au backend de générer un identifiant unique pour la ressource. À terme, c’est à la base de données de s’occuper de cette tâche, car elle seul a accès à l’ensemble des données de l’application.
  • On ne peut pas interagir directement avec le format JSON depuis notre API Rest, car les données entrantes et sortantes sont stringifier. Nous devons donc utiliser un Middleware dans notre API Rest, afin d’utiliser le format JSON dans les traitements de nos points de terminaison.
  • Pour le endpoint d’une modification d’une ressource, il est nécessaire de renvoyer une nouvelle ressource complète, avec la modification appliquée dessus. On ne peut pas se contenter d’envoyer seulement les champs que l’on souhaite modifier.
  • Pour le endpoint de suppression d’une ressource, il faut faire attention à supprimer uniquement la ressource concernée et non la collection de toutes les ressources. Une erreur d’inattention peut être très coûteuse.