Design First : OpenApi et AsyncApi en action !
Détails :
Aujourd’hui en terme d’API nous notons deux grandes familles, les API Synchrones (de type REST par exemple) et Asynchrone (Messaging, Topic).
Afin d’uniformiser et de spécifier des contrats d’interface clair, deux spécifications ont peu à peu emmergées : OpenApi d’un côté pour les API REST et AsyncApi dans le cadre des architecture évenmentielles (EDA).
Nous allons voir au travers de ce talk et de démos ce qu’apportent ces deux spécifications en terme de design, de documentation mais également en terme de génération de code.
Ce principe appelé Design First consiste à Définir son API (REST ou Asynchrone) en amont et de bénéficier d’outils divers et variés pour manipuler ces contrats.
Je ne prétends pas détenir la vérité absolue, ce sont plutôt mes réflexions au grès de mes expériences autour des APIs REST puis désormais Asynchrones que j’essaye de promouvoir auprès de clients et développeurs.
