Si aún no utiliza un lenguaje de definición para especificaciones API legibles por máquina, como OpenAPI (anteriormente conocido como Swagger), definitivamente debería considerar hacerlo. Después de todo, las API son lenguajes para que las máquinas se comuniquen entre sí.
¿Es Swagger una buena idea?
Swagger da una muy buena primera impresión Además, mucha gente piensa que la posibilidad de generar código a partir de la documentación es una buena idea y Swagger proporciona eso también. Entonces, el hecho de que la arrogancia cause una excelente primera impresión hace que sus limitaciones y restricciones sean menos evidentes.
¿Cuál es el propósito de usar Swagger?
Swagger le permite describir la estructura de sus API para que las máquinas puedan leerlas. La capacidad de las API para describir su propia estructura es la raíz de toda la genialidad de Swagger.
¿Se sigue usando Swagger?
Hoy en día, muchos usuarios todavía usan los términos " Swagger" para referirse al formato de especificación OpenAPI 2.0, y "Swagger spec" para referirse a un documento de descripción de API en este formato. RepreZen API Studio usa estos términos en algunas partes de la interfaz de usuario, pero se refiere a OpenAPI 3.0 y versiones posteriores como "OpenAPI ".
¿Swagger es solo para API REST?
La especificación OpenAPI (anteriormente especificación Swagger) es un formato de descripción de API para las API REST. Un archivo OpenAPI le permite describir toda su API, incluidos: Puntos finales disponibles (/usuarios) y operaciones en cada punto final (GET /usuarios, POST /usuarios)
