APIcurio registry
API Management
Repositorio de APIs
Raras veces nos encontramos repositorios de APis que soporten open que no sea swaggerhub y que además permita actualizar las APis dentro del mismo. La primera impresión que nos da es muy agradable, con una interfaz muy cuidada.
La instalación basada en docker, es bastante sencilla y te permite una ejecución rápida y sencilla para su utilización.
Para los que hemos estado unos años en Java, la nomenclatura (artifacts) nos suena bastante, similar al artifactory y pronto podemos entender cual va a ser su funcionamiento.
Información y validación de la API
Además de la información y descarga del swagger, vemos que nos permite validar el consultar la compatibilidad de del nuevo documento que subimos. Debemos tener en cuenta, que se soporta gran cantidad de formatos, como OpenAPI, GraphQL o AsynAPI, y eso ayuda a tener un respositorio unificado de apis.
Validación y compatibilidad
Como hemos indicado anteriormente, no sólo podemos validar los documentos, si no que podemos comprobar la compatibilidad de la API con las Apis anteriores. En la imagen vemos la matriz de validación / compatibilidad.
Documentación
Como vemos en la imagen, el esquema de documentación es bastante usable, utilizando el esquema de 3 columnas que hace que documentación y ejemplos vayan sincronizados.
Echamos de menos una herramienta de try-out, que nos permita probar la API directamente.
Documentación
Dentro de la pestaña nos permite visualizar la documentación formateada correctamente. Quizá echamos de menos que el documento openapi nos lo pueda enseñar en formato yaml y que exista una previsualización, para poder analizar mejor el documento sin necesidad de descargarlo. Además, y aunque no es su función, podría ser interesante poder modificarlo directamente.
Conclusiones
https://www.apicur.io/
Aunque el mundo se ha convertido en un mundo de APIs, existe una gran deficiencia de herramientas opensource que puedan cubrir todo el ciclo de vida. En este caso, APICurio es una herramienta muy interesante, que puede servir perfectamente como repositorio de APIs y que quién sabe, en un futuro pueda competir con swagger hub, el líder en OpenAPI.
Leave a comment
You must be logged in to post a comment.