feat(mpuniapp): 实现用户端网络拦截器与 API 客户端基础契约 (Task 06)

mpuniapp/common/api.uts

@@ -0,0 +1,45 @@
+/**
+ * OmniCard AI (CRMmp) - 用户端面向微官网与名片的核心 API 客户端
+ * 严格遵循 AGENTS.md 规范与 uts 强类型约束
+ */
+
+import {
+  CardPortalDetail,
+  LeadEntity,
+  RadarTrack,
+  SubmitLeadParams,
+  RecordRadarTrackParams,
+} from './types.uts';
+import { httpGet, httpPost } from './request.uts';
+
+/**
+ * 获取微官网与名片公开聚合详情 (包含 Hero、Bento 块、多语言与品牌 VI)
+ *
+ * @param cardIdOrSlug 名片主键 ID 或自定义短链标识
+ */
+export function fetchPortalCard(cardIdOrSlug: string): Promise<CardPortalDetail> {
+  return httpGet<CardPortalDetail>('/card/portal/info', {
+    id: cardIdOrSlug,
+  });
+}
+
+/**
+ * 提交无摩擦潜客留资 / 互换名片数据
+ *
+ * @param leadData 潜客留资信息
+ */
+export function submitLead(leadData: SubmitLeadParams): Promise<LeadEntity> {
+  return httpPost<LeadEntity>('/crm/lead/submit', leadData);
+}
+
+/**
+ * 记录访客实时雷达轨迹足迹 (停留时长、滚动深度、浏览块等)
+ *
+ * @param trackData 轨迹行为数据
+ */
+export function recordRadarTrack(trackData: RecordRadarTrackParams): Promise<RadarTrack> {
+  return httpPost<RadarTrack>('/crm/radar/track', trackData);
+}
+
+export * from './types.uts';
+export * from './request.uts';