docs: fixes and refactoring for API reference (#9708)

* docs: fixes and refactoring for API reference

* add route caching

* remove caching

* use next cache

www/apps/api-reference/lib/index.ts

@@ -0,0 +1,20 @@
+"use server"
+
+import { Area, ExpandedDocument } from "../types/openapi"
+
+const URL = `${process.env.NEXT_PUBLIC_BASE_URL}${process.env.NEXT_PUBLIC_BASE_PATH}`
+
+export async function getBaseSpecs(area: Area) {
+  try {
+    const res = await fetch(`${URL}/api/base-specs?area=${area}`, {
+      next: {
+        revalidate: 3000,
+        tags: [area],
+      },
+    }).then(async (res) => res.json())
+
+    return res as ExpandedDocument
+  } catch (e) {
+    console.error(e)
+  }
+}