docs(api): expose OpenAPI (Swagger) specification for OpenCRE REST API (#709)

* docs(api): add initial OpenAPI specification

* docs(api): add initial OpenAPI specification

* docs(api): expose OpenAPI specification via REST endpoint

Author: PRAteek-singHWY

application/web/web_main.py

@@ -378,6 +378,21 @@ def standards() -> Any:
     return standards
 
 
+@app.route("/rest/v1/openapi.yaml", methods=["GET"])
+def openapi_spec() -> Any:
+    """
+    Serve the OpenAPI specification for the OpenCRE REST API.
+    """
+    return send_from_directory(
+        directory=os.path.join(
+            os.path.dirname(os.path.realpath(__file__)),
+            "../../docs/api",
+        ),
+        path="openapi.yaml",
+        mimetype="application/yaml",
+    )
+
+
 @app.route("/rest/v1/text_search", methods=["GET"])
 def text_search() -> Any:
     """