Swagger

Herramientas basadas en la especificación OpenAPI para describir lo que acepta y devuelve una API HTTP, y para generar documentación y clientes a partir de esa descripción.

He usado Swagger y la especificación OpenAPI para diseñar, documentar y estandarizar contratos de API REST. En mi puesto actual en UW-Milwaukee me apoyo en las definiciones de Swagger de los proveedores para averiguar cómo interactuar con los productos SaaS que compramos.

Usado en

Bader Rutter, UW-Milwaukee

Sitio web oficial

swagger.io

Antigüedad

15 años (desde 2011)

Aspectos destacados

• Diseño especificaciones de API legibles por máquina y documentación interactiva, primero en Bader Rutter y ahora en UW-Milwaukee.
• Me aseguro de que los esquemas de peticiones y respuestas sean coherentes entre servicios y aplicaciones cliente.
• Leo las definiciones de Swagger de los proveedores para integrarme con plataformas SaaS adquiridas.