docs: 登记人群分类查询优化任务(T-209)
This commit is contained in:
+46
-1
@@ -11,7 +11,7 @@
|
||||
| JKDA00001 | `/jkda/create` | `CreateHealthRecord` | `health_record` |
|
||||
| JKDA00003 | `/jkda/update` | `UpdateHealthRecord` | `health_record` |
|
||||
| JKDA00002 | `/auto/jkda/find` | `FindHealthRecord` | (查询) |
|
||||
| JKDA00005 | `/jkda/findrqbj` | `FindPersonSign` | (查询) |
|
||||
| JKDA00005 | `/auto/jkda/findrqbj` | `FindRqbj` | (查询) |
|
||||
| JKTJ00001 | `/jktj/create` | `CreateHealthCheck` | `health_check` |
|
||||
| JKTJ00003 | `/jktj/update` | `UpdateHealthCheck` | `health_check` |
|
||||
| JKTJ00002 | `/auto/jktj/query` | `QueryHealthCheck` | (查询) |
|
||||
@@ -315,3 +315,48 @@ T-206 已建立本地契约与客户端方法,真实写入验收暂未执行
|
||||
|
||||
- **响应 `data`(list,每人一行)· 实测字段名**(⚠ 与 docx 多处不符,以实测为准):
|
||||
`idCard`/`personName`/`age`/**`birthday`**(docx 误写 birthDay)/`sexCode`/`regionCode`/`regionCodeText`/`manaUnitId`/`manaUnitText`/**`manaDoctorId`**(docx 误写 manadoctorId)/**`manaDocterName`**(拼写 Docter)/**`phrId`**(docx 误写 phrid,此处驼峰)/**`empiId`**/`signFlag`(y/n 签约)/`address`/`mobileNumber`/`contact`/`contactPhone`/**`checkType`(0已检/1未检)**/`rqbj`(人群标志,同 personSign 码表)。
|
||||
---
|
||||
|
||||
## 12. JKDA00005 人群分类查询 · 联调实测契约(T-209)
|
||||
|
||||
> 来源:2026-07-09 本地探针 `scripts/query_crow_with_idcard.py` 与返回样本 `scripts/query_crow_with_idcard.json`。样本含真实身份证和档案号,只本地留存、不入库;本文只记录脱敏结构。
|
||||
|
||||
### 12.1 请求
|
||||
|
||||
```json
|
||||
{
|
||||
"serviceId": "JKDA00005",
|
||||
"uploadinfo": {
|
||||
"baseInfo": { "idCard": "<idCard>" },
|
||||
"manageInfo": { "DSFMC": "<userName>", "operateUser": "<operateUser>", "operateUnit": "<orgCode-18位>" }
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
- 路径:`/osi/api/auto/jkda/findrqbj`。
|
||||
- `baseInfo` 支持 `idCard` / `phrid` 二选一;实测样本使用 `idCard`。
|
||||
- 注意:早期代码/文档登记为 `/jkda/findrqbj`,本次实测脚本使用 `auto/jkda/findrqbj` 返回 `code="01"`,T-209 需同步修正 `osi/codes.go`。
|
||||
|
||||
### 12.2 响应
|
||||
|
||||
```json
|
||||
{
|
||||
"code": "01",
|
||||
"message": "操作成功",
|
||||
"data": {
|
||||
"personSign": "LAO",
|
||||
"idCard": "<idCard>",
|
||||
"phrId": "<phrId>"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
字段说明:
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| `personSign` | string | 人群分类码,可能为逗号分隔多值;码表见 §3 `personSign` |
|
||||
| `idCard` | string | 身份证号,PII |
|
||||
| `phrId` | string | 健康档案号,响应为驼峰 `phrId` |
|
||||
|
||||
Go 侧契约应从只承接 `personSign` 优化为完整承接 `personSign/idCard/phrId`,server 端点原样回写平台 JSON,避免裁掉后续可能新增字段。
|
||||
|
||||
Reference in New Issue
Block a user