(The Minspait Crowd) Soporte Open API 3 en API Manager de Plataforma
El equipo «The Minspait Crowd», compuesto por Francisco Javier, Erika y Giusseppe y mentorizados por Javier asumió el reto de implementar el soporte del estándar Open API 3 en el API Manager de Onesait Platform.
El Reto
![](https://onesaitplatform.atlassian.net/wiki/download/thumbnails/200736786/image2019-10-8_10-57-20.png?version=1&modificationDate=1570525042795&cacheVersion=1&api=v2&width=1068&height=278)
El reto consistía en soportar el estándar OpenAPI3 en plataforma, lo que implicaba los siguientes requisitos:
- Soportar la publicación de APIs externas a partir de documentación Swagger Open API 3 para permitir la integración de servicios de terceros.
- Generación de documentación Swagger Open API 3 para el resto de APIs: APIs internas de plataforma.
- Mantener retrocompatibilidad con APIs con documentación Swagger 2, es decir, seguir dando soporte a APIs que sigan el estándar Swagger 2.0.
Las principales diferencias entre ambos estándares se pueden observar en el siguiente stack comparativo.
![](https://onesaitplatform.atlassian.net/wiki/download/thumbnails/200736786/image2019-10-8_11-0-17.png?version=1&modificationDate=1570525219327&cacheVersion=1&api=v2&width=1800&height=900)
A continuación mostramos un ejemplo de la misma API en formato Swagger 2.0 frente al formato Open API 3.0:
Componentes modificados
A nivel de módulo, el equipo desarrolla sobre el API Manager de plataforma, adaptando el código para cumplir con los requisitos del reto.
![](https://onesaitplatform.atlassian.net/wiki/download/thumbnails/200736786/image2019-10-7_11-7-45.png?version=1&modificationDate=1570439267410&cacheVersion=1&api=v2&width=1800&height=790)
Repositorio de Github
El equipo estuvo trabajando sobre un repositorio público que contenía el código de la versión Community de la Plataforma: https://github.com/onesaitplatform/onesaitplatform-revolution-the-minspait-crowd