Tras una mala experiencia con algunos equipos de backend que cambiaban el API a su voluntad sin informar de ninguna manera a la gente de frontend decidimos introducir el paradigma API First en nuestro desarrollo, adoptando para ello las especificaciones de OpenAPI. Esto, unido a un desarrollo basado en contratos nos permitiría detectar mucho antes dichos cambios y no llegar a momentos críticos al final de un sprint.

Entre los problemas que nos encontramos estaban la dependencia de java que tenían todas las herramientas que nos encontramos, por lo que tomamos la decisión de construir nuestro propio CLI en nodejs. De esta necesidad nacen varias aplicaciones dirigidas a distintos momentos del desarrollo. Siguiendo las especificaciones contenidas en un fichero OpenAPI, queríamos:

- crear automáticamente código en javascript o typescript, tanto para cliente como para servidor, de forma que ahorremos mucho tiempo que podemos dedicar a pensar. Esta funcionalidad ya está disponible dentro de la aplicación openapi-nodejs-cli
- crear automáticamente un servidor de mocks, que nos permite que el equipo de front no tenga que esperar a que el API esté terminado
- revisar que un API cumple las especificaciones OpenAPI indicadas, lo cual nos permite hacer pruebas dentro del flujo de desarrollo para una detección temprana de los cambios en el API

En esta sesión contaremos la historia detrás del desarrollo y el uso de este producto. Haremos una pequeña demostración de cómo se utiliza y de qué podemos hacer con él. Nuestra charla no es puramente técnica, por lo que le puede interesar a cualquier persona involucrada en el ciclo de desarrollo de software: desarrolladores, managers, product owners, QA... La sesión durará aproximadamente media hora, entre charla y demo.