/** 平台总后台的共享 HTTP 客户端,统一处理响应体和 JWT 请求头。 */ const apiBaseURL = import.meta.env.VITE_API_BASE_URL || 'http://localhost:12426/heqi/platform/v1'; export const tokenStorageKey = 'token'; export type PageResult = { total: number; list: T[] }; // 将后端 SDK 的通用英文错误转换为面向用户的中文提示。 const API_ERROR_MESSAGES: Record = { 'Invalid Argument': '请求参数不正确,请检查填写内容', }; // 优先保留后端提供的具体中文信息,仅翻译已知的通用英文错误。 function localizeApiErrorMessage(message?: string) { if (!message) return '请求失败'; return API_ERROR_MESSAGES[message.trim()] ?? message; } export async function request(path: string, init?: RequestInit): Promise { const token = localStorage.getItem(tokenStorageKey); let response: Response; try { response = await fetch(`${apiBaseURL}${path}`, { ...init, headers: { 'Content-Type': 'application/json', ...(token ? { Authorization: token } : {}), ...(init?.headers ?? {}), }, }); } catch { throw new Error('无法连接服务器,请确认服务已启动'); } const payload = (await response.json()) as { code?: number; message?: string; details?: T }; if (!response.ok || payload.code !== 0) { throw new Error(localizeApiErrorMessage(payload.message)); } return payload.details as T; }