Hoy he estado leyendo sobre Swagger y muy interesante.

Puedes crear una documentación de APIS y te genera una web en la que puedes probar todos los endpoints y quedan documentados.

Encima tiene una función para generar código que haga de wrapper de la API sin programar nada.

Por cierto,

¿Hay alguna forma de sacar los yaml de los endpoints en Python y flask sin tener que picar el yaml a mano?