API First - Primero entendamos el negocio y después lo codificamos

Abstracto

API First - Primero entendamos el negocio y después lo codificamos

API First es un patrón de diseño que se enfoca en crear primero de la interfaz de la aplicación basado en los requerimientos del negocio y posteriormente codificarla. Analizaremos las ventajas y desventajas de este patrón de diseño, la especificación OpenAPI 3.0, las herramientas y buenas prácticas en Python para implementarla

Descripción

Es muy común que como programadores o lideres de técnicos cuando nos involucramos en un proyecto de software, cometemos el error de comenzar a programar y sobre la marcha vamos entendiendo las necesidades del negocio o los requerimientos específicos de nuestros clientes, esto trae como consecuencia demoras en entregas, rehacer código, pruebas con pocos casos de usos, mas deuda técnica de lo normal y el proyecto termina como un “Frankenstein”.

Implementar la arquitectura API First puede ayudar a cambiar paradigmas en la construcción de aplicaciones, ser más consiente de las áreas y usuarios que usarán tu software y así evitar mucho de los errores o malas prácticas que comúnmente cometemos.

En esta charla veremos la importancia de definir la API primero, antes de codificar su implementación, utilizando un lenguaje de especificación estándar, en nuestro caso usaremos OpenAPI (anteriormente conocido como Swagger), esto nos permite interactuar mas con las necesidades del cliente y tener comentarios tempranos sobre el diseño.

Veremos ventajas y desventajas de esta arquitectura y algunos ejemplos con Python.