OpenAPI DevTools - extensión de Chrome que genera especificaciones de API automáticamente

• Genera especificaciones OpenAPI en tiempo real basadas en las solicitudes de red de una página web
• Agrega una nueva pestaña llamada 'OpenAPI' a Chrome DevTools
  • Genera al instante una especificación OpenAPI 3.1 para un sitio web o aplicación
  • Combina automáticamente nuevos encabezados, cuerpos y parámetros de consulta de solicitudes y respuestas por endpoint
  • Al hacer clic en parámetros de ruta, combina solicitudes coincidentes existentes y futuras
  • Permite ver la especificación dentro de la herramienta usando Redocly y descargarla con un clic
• La extensión completa automáticamente la especificación con base en las solicitudes JSON que ocurren mientras navegas por la web
• En el menú de configuración se pueden filtrar hosts y parametrizar rutas de la URL
• Aunque el mismo endpoint responda con datos distintos, la extensión incluye toda la información en la especificación final
• El proceso de combinación de solicitudes no se puede deshacer, pero el usuario puede borrar la especificación y volver a empezar en cualquier momento

[GN⁺]

Comentarios en Hacker News

• La extensión de Chrome OpenAPI DevTools es reconocida por su capacidad para generar especificaciones de API.
• Los usuarios consideran que es útil para escribir código en la consola de JavaScript que les permite ejecutar tareas complejas rápidamente.
• Una de las sugerencias para esta herramienta es documentar los headers de autenticación y guardar los valores de los tokens para facilitar el uso de la API.
• Se solicitó una función de botón de "copiar como request de Python" para generar snippets boilerplate de Python.
• Esta herramienta se compara con otras similares como vite-plugin-web-extension y mitmproxy2swagger, y se destacó que la funcionalidad como extensión de navegador es muy conveniente.
• La herramienta recibió elogios por su capacidad para descifrar la API de sitios web, lo cual puede ser una tarea complicada.
• Se plantearon dudas sobre la capacidad de la herramienta para manejar valores opcionales y marcar campos de texto como "enum".
• Puede verse a esta herramienta como un paso hacia convertir toda la web en una API, a pesar de las barreras de inicio de sesión/registro.
• También surgieron varias sugerencias de funciones, como filtrado de propiedades de respuesta, trabajo con datos que no son JSON, cruce con APIs documentadas públicamente y nombres de host, almacenamiento local de credenciales de usuario y generación de clientes basada en la especificación OpenAPI.