11

src/api/client.js

@@ -0,0 +1,62 @@
+/** API 基址：开发走 Vite 代理 `/api`；生产可设 VITE_API_BASE_URL */
+const API_BASE = import.meta.env.VITE_API_BASE_URL || "/api/v1";
+
+function formatValidationDetail(detail) {
+  if (!Array.isArray(detail)) {
+    return "请求参数无效";
+  }
+  const first = detail[0];
+  if (first?.msg) {
+    return String(first.msg);
+  }
+  return "请求参数无效";
+}
+
+/**
+ * @param {string} path - 相对路径，如 `/auth/register`
+ * @param {RequestInit} options
+ * @returns {Promise<{ ok: boolean, message: string, data?: unknown }>}
+ */
+export async function apiRequest(path, options = {}) {
+  const url = `${API_BASE}${path}`;
+  const headers = {
+    "Content-Type": "application/json",
+    ...options.headers,
+  };
+
+  let res;
+  try {
+    res = await fetch(url, { ...options, headers });
+  } catch {
+    return { ok: false, message: "无法连接服务器，请确认后端已启动" };
+  }
+
+  let body = null;
+  try {
+    body = await res.json();
+  } catch {
+    body = null;
+  }
+
+  if (res.status === 422) {
+    return {
+      ok: false,
+      message: formatValidationDetail(body?.detail),
+    };
+  }
+
+  if (body && typeof body.ok === "boolean") {
+    return body;
+  }
+
+  if (res.status === 401) {
+    return { ok: false, message: "未登录或登录已过期" };
+  }
+
+  return {
+    ok: false,
+    message: body?.message || `请求失败（${res.status}）`,
+  };
+}
+
+export { API_BASE };