Ya había terminado todas las pruebas de API con Swagger o Postman, pero sentía que escribir la documentación a mano por separado en Notion era algo repetitivo e ineficiente, así que hice esto.
Qué hice: si subes cualquier archivo de Swagger/OpenAPI (.json, .yaml), Postman Collection (.json) o Insomnia Export (.json), lo convierte automáticamente en un documento Markdown organizado con ejemplos de endpoints, parámetros, solicitudes y respuestas. Puedes copiarlo y pegarlo tal cual en Notion o descargarlo como archivo .md para ponerlo en tu repositorio.
Cómo probarlo: si entras al enlace de arriba, verás de inmediato la pantalla de carga; incluso si no tienes un archivo a la mano, en la pantalla hay botones con archivos de ejemplo para cada formato, así que con un solo clic puedes ver el resultado enseguida.
Qué lo hace diferente: he visto herramientas parecidas que solo soportan Swagger, pero fue difícil encontrar una que también parseara archivos de exportación de Postman/Insomnia y los convirtiera a un formato unificado, así que tomé eso como punto diferencial. Detecta automáticamente qué formato es revisando el contenido del archivo.
Todavía no tiene función de inicio de sesión y, en el caso de Insomnia, aún no puede traer ejemplos de respuesta, así que está en una etapa inicial de MVP. Si lo usan de verdad y encuentran algo incómodo, o creen que debería soportar también algún otro formato, no duden en dejar su opinión en los comentarios.
Dejo aquí un texto donde explico un poco más por qué lo hice:
https://velog.io/@dkslasdud/…
Aún no hay comentarios.