diff --git a/docs/04-字段与接口映射.md b/docs/04-字段与接口映射.md index 4774517..69a47aa 100644 --- a/docs/04-字段与接口映射.md +++ b/docs/04-字段与接口映射.md @@ -260,14 +260,17 @@ T-206 已建立本地契约与客户端方法,真实写入验收暂未执行 ### 11.1 接口与状态 -| 业务 | serviceId | 路径 | 状态 | -| --- | --- | --- | --- | -| 最近一次体检 | `JKTJLSJL00002` | `/auto/jktjlscx/query` | ✅ 实测可用(`osi.LastHealthCheck`) | -| 已检/待检列表 | `JKTJLIST00002` | `/auto/jktjlist/query` | 路径已登记;入参(机构/日期/分页)待厂家确认 | -| 单条按体检 id 查 | `JKTJ00002` | docx 标 `/auto/jktj/query` | ⚠ 实测返回"没有url的接口配置"(**未部署**);`/auto/jktj/find` 待确认,见 docs/06 B5 | +| 业务 | serviceId | 路径 | 返回 | 状态 | +| --- | --- | --- | --- | --- | +| 最近一次体检 | `JKTJLSJL00002` | `/auto/jktjlscx/query` | 单对象(最近一次完整体检) | ✅ 实测可用(`osi.LastHealthCheck`) | +| 某人全部体检 | `JKTJ00002` | `/auto/jktj/query` | **数组**(该人全部体检,每条完整) | ⚠ docx 有定义,实测"没有url的接口配置"(**未部署**),见 docs/06 B5 | +| 已检/待检名单 | `JKTJLIST00002` | `/auto/jktjlist/query` | 数组(人员名单+状态,非体检明细) | ✅ 实测可用(`osi.ListHealthCheckPeople`,见 §11.4) | -- 请求信封同档案(`serviceId` + `uploadinfo{baseInfo, manageInfo}`);查询按 `idCard`/`phrid`/`empiId` 之一。 +- 请求信封同档案(`serviceId` + `uploadinfo{baseInfo, manageInfo}`);查询按 `phrid`/`idCard` 之一(docx baseInfo 只列这俩)。 - **两处与档案不同的坑**:① 最近一次的 `data` 是**单个对象**(档案 find 是数组);② 体检身份证字段是小写 **`idcard`**(档案是 `idCard`)。 +- **JKTJ00002 返回形态**:`data` 为**数组**,每个元素是一份**完整体检**(结构同"最近一次",约 260 项 + 各子节点,见 §11.3),每条含自己的 `checkId`(体检编号,响应字段,长度 20)。 + - docx 无"按 `checkId` 直接查单条"的接口——`checkId` 只是响应字段。要按体检编号取历史某次,须用本接口查该人全部体检,再**本地按 `checkId` 过滤**。 + - 部署后即为"查历史体检 / 按体检编号定位"的正解接口;未部署前只有"最近一次"可用。 ### 11.2 记录结构与主键