Conception d’une description API

Si l’on conçoit une API qui suit une version de la norme OpenAPI, cela ne signifie pas forcément qu’elle sera utilisable, car les générateurs de code n’implémentent pas toujours du code qui couvre l’intégralité de la norme. Il faut la tester avec les outils Swagger et OpenAPI, au niveau de la génération du code des DTO mais aussi des contrôleurs et des clients REST. Il faudrait tester des combinatoires Spring MVC/Spring WebFlux, Java/Kotlin, dans les différentes versions de ces derniers. Les API qui utilisent le polymorphisme et l’héritage devront être particulièrement testées.

Il faudra indiquer les configurations testées avec si possible le code généré avec sa façon de le tester car beaucoup de problèmes ne se voient qu’au runtime.