Add OpenAPI/Swagger docs at /api/docs

Full OpenAPI 3.0.3 spec with all 30+ endpoints, schemas, and query params. Swagger UI served from unpkg CDN at /api/docs, raw spec at /api/openapi.yaml.
2026-03-16 03:15:56 +01:00
parent e79e1d1736
commit 83ab8c4cf9
2 changed files with 2033 additions and 0 deletions
@@ -0,0 +1,43 @@
+use axum::http::{header, HeaderValue};
+use axum::response::{Html, IntoResponse};
+
+const OPENAPI_SPEC: &str = include_str!("../../openapi.yaml");
+
+pub async fn openapi_yaml() -> impl IntoResponse {
+    (
+        [(header::CONTENT_TYPE, HeaderValue::from_static("text/yaml; charset=utf-8"))],
+        OPENAPI_SPEC,
+    )
+}
+
+pub async fn swagger_ui() -> impl IntoResponse {
+    Html(r#"<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>HerbAPI — API Documentation</title>
+  <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
+  <style>
+    html { box-sizing: border-box; overflow-y: scroll; }
+    *, *::before, *::after { box-sizing: inherit; }
+    body { margin: 0; background: #fafafa; }
+  </style>
+</head>
+<body>
+  <div id="swagger-ui"></div>
+  <script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js"></script>
+  <script>
+    SwaggerUIBundle({
+      url: '/api/openapi.yaml',
+      dom_id: '#swagger-ui',
+      deepLinking: true,
+      presets: [
+        SwaggerUIBundle.presets.apis,
+        SwaggerUIBundle.SwaggerUIStandalonePreset,
+      ],
+      layout: 'BaseLayout',
+    });
+  </script>
+</body>
+</html>"#)
+}