api swagger definition
 Versión actual: 2.0. La versión actual de la especificación OpenAPI es 2.0 y puede encontrarla aquí. Este repositorio contiene la especificación Swagger 1.2 existente, así como propuestas para la versión 2.0. Como prometí en mi publicación anterior, le mostraré cómo escribir una definición de API con el formato de especificación OpenAPI (antes conocido como especificación Swagger). Este tutorial estará compuesto por varias publicaciones:  El marco más popular del mundo para API. ¡Buenas noticias para la comunidad Swagger! A partir del 1 de enero de 2016, la especificación Swagger se donó a la Open API Initiative (OAI) y es la base de la especificación OpenAPI. Swagger es una representación simple pero poderosa de su API RESTful. Con el ecosistema de herramientas API más grande del planeta, miles de desarrolladores brindan soporte a Swagger en casi todos los lenguajes de programación y entornos de implementación modernos.  Sin embargo, requiere que las capacidades del servicio se describan en la estructura de la Especificación OpenAPI. OpenAPI no puede describir todos los servicios; esta especificación no pretende cubrir todos los casos de uso posibles de una API REST-ful. Mira aquí. El objetivo de la especificación OpenAPI es definir una interfaz estándar independiente del lenguaje para las API REST que permita tanto a humanos como a computadoras descubrir y comprender las capacidades del servicio sin acceso al código fuente, documentación o mediante inspección del tráfico de red.  Swagger-Codegen contiene un motor basado en plantillas para generar documentación, clientes API y resguardos de servidor en diferentes idiomas analizando la definición de OpenAPI/Swagger.  Los casos de uso para interfaces API legibles por máquina incluyen documentación interactiva, generación de código para documentación, cliente y servidor, así como casos de prueba automatizados. Las API habilitadas para OpenAPI exponen archivos JSON que cumplen correctamente con la especificación OpenAPI, documentada en este repositorio. Una potente interfaz para su API. Swagger es una representación simple pero poderosa de su API RESTful. Con el ecosistema de herramientas API más grande del planeta, miles de desarrolladores brindan soporte a Swagger en casi todos los lenguajes de programación y entornos de implementación modernos.  Como prometí en mi publicación anterior, le mostraré cómo escribir una definición de API con el formato de especificación OpenAPI (antes conocido como especificación Swagger). Esta primera parte explica qué es la especificación OpenAPI, por qué la usará y qué herramientas puede usar para escribir estas especificaciones.  ¿Por qué utilizar un lenguaje de definición de API como la especificación OpenAPI? El uso de un lenguaje de definición de API, como la especificación OpenAPI, ayuda a describir fácil y rápidamente una API. Es particularmente útil cuando estás en el proceso de diseño de tu API (ver mi primera publicación de la serie).
 Swagger es una representación simple pero poderosa de su API RESTful.