跳到主要内容

匿名读取与登录态数据读写

选择通道​

公开匿名数据使用 public-api.js 与公共记录读取；登录态读取使用 appFormPage/List/Detail；标准业务写入使用 appFormInsert/Upsert/Update/Delete。页面只消费 repository 或 action。

登录态读取示意​

下例仅展示仓储层调用形态，formId 和 recordId 必须来自真实业务合同：

import {appFormDetail} from '@/services/api/app-openapi'

const result = await appFormDetail({formId, id: recordId})

分页入口统一适配 page/current、条件 compare 与字段选择，不在页面重复拼协议。新增列表必须验证后续页和空结果，禁止只请求固定第一页冒充全量。

写入确认​

  1. 检查当前会话与操作权限，构造最小修改集。
  2. 使用 V2 facade 提交，更新必须带真实记录 ID。
  3. 从写响应提取真实记录 ID；缺失时明确报错，不能用本地临时 ID 继续。
  4. 读取详情核对目标字段、归属和关联，再更新页面成功态。
  5. 响应不确定时先查询原请求结果，避免创建重复记录。

统一客户端处理 Bearer 与会话恢复。禁止跨 HTTP method 静默兜底，禁止把 V2 失败自动降为旧写接口。公开读取 token 不能作为用户态业务写的身份。

upsert 是否可用取决于真实唯一字段合同，不满足时不能由客户端猜测去重规则。