Swagger es el nombre (histórico) de un conjunto de herramientas y una especificación para documentar y probar APIs REST.
En la práctica, cuando alguien dice “tengo Swagger”, suele referirse a una de estas cosas: OpenAPI Specification (OAS): es el “estándar” actual para describir una API en un archivo YAML/JSON (endpoints, parámetros, respuestas, auth…). Antes se llamaba “Swagger”, y hoy el nombre formal es OpenAPI. Swagger UI: una web que, a partir del archivo OpenAPI, te muestra la documentación interactiva y te deja probar endpoints con botones tipo “Try it out”. Swagger Editor: editor online/local para escribir y validar el OpenAPI. Swagger Codegen / OpenAPI Generator: herramientas para generar clientes, SDKs o stubs de servidor desde la especificación. Para qué sirve Tener documentación viva alineada con el código. Facilitar a frontend/QA la prueba rápida de la API. Generar clientes o mocks automáticamente.
Ejemplo simple Si un backend expone /swagger o /swagger-ui, normalmente es Swagger UI, y ahí puedes ver: rutas disponibles (GET /users, POST /login, etc.) qué campos pide cada endpoint ejemplos de respuesta cómo autenticarse (Bearer token, API key…)
