sample code: 
from odoo.http import Controller, route, request

 class SampleApi (Controller):
    @route ("/ sample-route", type = "json", auth = "user", methods = ["GET"])
    def sample_route (self):
        return {
            "status": 200,
            "message": "Sample api response"
        }
requirement:  generate swagger yaml using this route / class