L’API est un peu de Graal des données mais elle a un défaut majeur : Une fois publiée vous n’en contrôlez plus les clients et faire évoluer les bases n’est pas évident.
Ce que vous construisez est là pour longtemps. Quelles sont les retours d’expériences et bonnes pratiques pour ne pas se prendre les pieds dans le tapis ?
Vous avez certainement déjà entendu parler de REST mais les choses sont plus complexes que ça. Comment gérer les évolutions et les versions de l’API ? les formats en entrée et en sortie ? les variations et paramètres d’une même ressources ? les relations entre ressources ? la sécurité ? l’authentification ? la gestion des erreurs ? la pagination ? l’i18n et l10n ? Qu’est-ce que l’hypermedia ?. .
Plus généralement, nous partons avec pour objectif premier de concevoir une API le plus tôt possible, avec des bases solides mais les plus simples possible.