Saltar al contenido

¿Cómo exportar un archivo Swagger JSON/YAML desde la interfaz de usuario de Swagger?

Posteriormente a buscar en varios repositorios y páginas webs al final hallamos la respuesta que te mostramos aquí.

Solución:

La URL de la definición de la API se muestra en la barra superior de la interfaz de usuario de Swagger; en su ejemplo, es

/v2/api-docs?group=full-petstore-api

Así que la URL completa parece ser

http://localhost:8080/v2/api-docs?group=full-petstore-api

En las versiones más recientes de la interfaz de usuario de Swagger, el enlace a la definición de la API suele mostrarse debajo del título de la API, por lo que puede hacer clic con el botón derecho en el enlace y Guardar como.

Enlace a la definición de API en Swagger UI 3.x

Si su interfaz de usuario de Swagger no tiene un enlace visible a la definición de la API, vea la fuente de la página y busque el url parámetro, como:

const ui = SwaggerUIBundle({
  url: "https://petstore.swagger.io/v2/swagger.json",     // <-------
  dom_id: '#swagger-ui',

Si no ves el url o si url es una expresión de código, abra las herramientas de desarrollo del navegador, cambie a la La red pestaña y deshabilite el almacenamiento en caché. Luego actualice la página y busque el archivo de definición de API (swagger.json, swagger.yaml, api-docs o similar) entre las solicitudes HTTP. Puedes filtrar por XHR para reducir la lista.

Encontrar el archivo Swagger en la pestaña Red de las herramientas de desarrollo del navegador

Otra forma de encontrar el verdadero url es usar la consola del navegador y evaluar uno de los siguientes valores, según la versión de la interfaz de usuario:

  • Interfaz de usuario de Swagger 3.x:

    ui.getConfigs().url
    
  • Interfaz de usuario de Swagger 2.x:

    swaggerUi.api.url
    

A veces, la definición de OpenAPI puede estar incrustada en un archivo .js; en este caso, tome este archivo y elimine las partes adicionales.

Definición de OpenAPI incrustada en un archivo JavaScript

Aunque ya ha sido respondida y es la correcta, pensé que publicaría la versión más detallada. Espero que esto ayude,

  1. Si tiene el archivo swagger json que alimenta a la interfaz de usuario de swagger, entonces para generar el archivo .yaml simplemente haga clic en el siguiente enlace, copie y pegue su json en el editor y descargue el archivo yaml. Este es un método directo

enlace: https://editor.swagger.io/#

  1. Ahora, la segunda forma en la que no tiene ningún archivo swagger json, entonces los siguientes pasos deberían ayudar,

Abra la interfaz de usuario de Swagger, inspeccione (Shift + Ctrl + i), actualice la página y obtendrá las pestañas como a continuación

ingrese la descripción de la imagen aquí

Escoger XHR o Todas las pestañas debajo La red pestaña, verifique el archivo api-doc?group=* y haga clic en la subpestaña respuesta. *Ahora copie el contenido del archivo ap-doc?group.** y use el mismo enlace del editor para convertirlo a un archivo yaml

enlace: https://editor.swagger.io/#

El JSON también puede estar integrado en el documento, específicamente para la versión 2.0 de Swagger. Si no ha encontrado nada después de revisar la respuesta de @Helen, intente esto:

  1. Ver código fuente
  2. Buscar "swagger" o "spec"

si ves un

¡Haz clic para puntuar esta entrada!
(Votos: 0 Promedio: 0)



Utiliza Nuestro Buscador

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *