/** 平台总后台的共享 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[] }; /** 保留 HTTP 状态,供独立页面区分无权限、不存在和普通请求错误。 */ export class ApiError extends Error { constructor( message: string, public readonly status: number, ) { super(message); this.name = 'ApiError'; } } // 将后端 SDK 的通用英文错误转换为面向用户的中文提示。 const API_ERROR_MESSAGES: Record = { 'Invalid Argument': '请求参数不正确,请检查填写内容', 'Record Not Found': '记录不存在', 'Permission Denied': '无权访问该记录', }; // 优先保留后端提供的具体中文信息,仅翻译已知的通用英文错误。 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 ApiError( localizeApiErrorMessage(payload.message), response.status, ); } return payload.details as T; }