Better way to display the open api docs #548

vincenzopalazzo · 2024-11-14T00:18:03Z

vincenzopalazzo
Nov 14, 2024

Currently I am doing the following hack to display the open API docs, wondering if there is a better way to do it with a more recent version of the library?

#[actix::get("/")]
async fn swagger_api(data: web::Data<AppState>) -> HttpResponseWrapper {
    // FIXME: the url need to change here so we should support a better way
    let resp = HttpResponse::Ok().body(
        format!(r#"
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <meta
      name="description"
      content="SwaggerUI"
    />
    <title>SwaggerUI</title>
    <link rel="stylesheet" href="https://unpkg.com/[email protected]/swagger-ui.css" />
  </head>
  <body>
  <div id="swagger-ui"></div>
  <script src="https://unpkg.com/[email protected]/swagger-ui-bundle.js" crossorigin></script>
  <script src="https://unpkg.com/[email protected]/swagger-ui-standalone-preset.js" crossorigin></script>
  <script>
    window.onload = () => {{
      window.ui = SwaggerUIBundle({{
        url: 'http://{}/api/v1',
        dom_id: '#swagger-ui',
        presets: [
          SwaggerUIBundle.presets.apis,
          SwaggerUIStandalonePreset
        ],
        layout: "StandaloneLayout",
      }});
    }};
  </script>
  </body>
</html>
"#, data.host),
    );
    HttpResponseWrapper(resp)
}

tiagolobocastro · 2024-11-14T06:51:18Z

tiagolobocastro
Nov 14, 2024
Maintainer

Have a look at with_swagger_ui_at.

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Better way to display the open api docs #548

{{title}}

Replies: 1 comment

{{title}}

Select a reply

Better way to display the open api docs #548

vincenzopalazzo Nov 14, 2024

Replies: 1 comment

tiagolobocastro Nov 14, 2024 Maintainer

vincenzopalazzo
Nov 14, 2024

tiagolobocastro
Nov 14, 2024
Maintainer