Saltar al contenido
Totalmente local

Listador de endpoints OpenAPI

Enumera cada endpoint de un documento OpenAPI o Swagger en una tabla legible.

Entrada

Listador de endpoints OpenAPI

Pega un documento OpenAPI o Swagger — JSON o YAML, OpenAPI 3 o Swagger 2 — y esta herramienta extrae cada endpoint en una lista legible. Está diseñada para cuando recibes un archivo de especificación y necesitas una visión general rápida antes de profundizar en los detalles: qué rutas existen, qué necesitan y qué devuelven.

Filtra la lista por método HTTP o por etiqueta para enfocarte en una parte de la API. Activa o desactiva los parámetros de ruta y consulta, el tipo de contenido del cuerpo de la solicitud, los códigos de respuesta y si un endpoint requiere autenticación — la herramienta lee los requisitos de seguridad por operación, usando los valores globales del documento cuando una operación no los especifica. Activa "Omitir endpoints deprecated" para ocultar rutas marcadas como deprecated en la especificación e incluye el campo de resumen de cada endpoint para obtener contexto adicional sin abrir el archivo de origen.

Ordena el resultado por ruta o por etiqueta, y elige un formato de salida que se adapte a lo que necesites después: una lista simple para un escaneo rápido, una tabla Markdown para pegar en documentación o una pull request, o CSV para abrir en una hoja de cálculo. Los parámetros definidos con $ref en lugar de inline se omiten en lugar de adivinarse, porque resolver una referencia correctamente requiere el resto del documento.

Todo se ejecuta localmente en tu navegador — la especificación de la API nunca sale de tu dispositivo, lo cual es importante cuando describe un servicio interno o no publicado. Copia el resultado, descárgalo como un archivo .txt o envíalo directamente a otra herramienta para seguir trabajando.

Preguntas frecuentes

¿Soporta tanto OpenAPI 3 como Swagger 2?
Sí. Ambos formatos mantienen los endpoints bajo una sección "paths" con la misma estructura, así que el mismo lector maneja cualquiera de las dos versiones.
¿Cómo decide si un endpoint necesita autenticación?
Comprueba primero el campo "security" de la operación. Un array vacío allí significa que ese endpoint desactiva explícitamente la autenticación; si el campo está ausente, la herramienta vuelve al parámetro "security" global del documento.
¿Puede resolver referencias $ref?
No para parámetros — un parámetro definido con $ref no tiene nombre inline, así que se omite en lugar de resolverse, ya que eso requeriría leer el resto del documento.
¿Qué sucede con un documento inválido o no relacionado?
Verás un mensaje claro: uno para el texto que no es JSON o YAML válido, y otro cuando el documento se analiza correctamente pero no tiene una sección "paths".
¿Se carga mi especificación de API en algún lugar?
No. El análisis y el formato ocurren completamente en tu navegador — el documento que pegas nunca sale de tu dispositivo.