Add interactive API docs at /docs endpoint

Swagger UI served via CDN for browsing OpenAPI spec. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 16:33:21 -06:00
parent 4262865520
commit 5e76ce9597
4 changed files with 33 additions and 2 deletions
--- a/aggregator.py
+++ b/aggregator.py
@@ -326,6 +326,35 @@ def list_events():
        return jsonify({"events": dict(active_events)}), 200


+@app.route("/docs")
+def docs():
+    """Serve interactive API documentation via Swagger UI."""
+    return """<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <title>Kao API Documentation</title>
+    <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
+    <style>
+        body { margin: 0; background: #fafafa; }
+        .swagger-ui .topbar { display: none; }
+    </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: '/openapi.yaml',
+            dom_id: '#swagger-ui',
+            presets: [SwaggerUIBundle.presets.apis, SwaggerUIBundle.SwaggerUIStandalonePreset],
+            layout: 'BaseLayout'
+        });
+    </script>
+</body>
+</html>"""
+
+
 def main():
    port = int(os.environ.get("PORT", 5100))