kola-web
2 weeks ago
13 changed files with 955 additions and 64 deletions
@ -0,0 +1,383 @@ |
|||||||
|
# V2.6.0 接口文档 - 甲状腺眼病患者注册字段新增 |
||||||
|
|
||||||
|
|
||||||
|
## 1. 注册接口 account/reg |
||||||
|
|
||||||
|
**路由**: `?r=zd/account/reg` |
||||||
|
**方法**: POST |
||||||
|
**需要登录**: 是（systemUserId） |
||||||
|
|
||||||
|
### 请求参数 |
||||||
|
|
||||||
|
| 参数名 | 类型 | 必填(version>=2.6.0) | 说明 | |
||||||
|
|---|---|---|---| |
||||||
|
| registrationSource | int | 否 | 注册来源 | |
||||||
|
| registChannel | int | 否 | 注册渠道 | |
||||||
|
| regBusinessId | string | 否 | 注册业务Id | |
||||||
|
| inviteDoctorId | int | 否 | 邀约医生Id | |
||||||
|
| inviteChannel | int | 否 | 邀约渠道 | |
||||||
|
| name | string | 否 | 姓名 | |
||||||
|
| relationType | int | 是 | 关系类型 1-本人 2-亲友 | |
||||||
|
| gender | int | 是 | 性别 1-男 2-女 | |
||||||
|
| ageRange | int | 否 | 年龄段 1-18以下 2-18-29 3-30-40 4-41-50 5-51-65 6-65以上 | |
||||||
|
| birth | string | 否 | 出生年月 YYYY-mm | |
||||||
|
| diagnosisTime | string | 否 | 确诊时间 YYYY-mm | |
||||||
|
| diagnoseType | int | 否 | 诊断类型 | |
||||||
|
| IsAliQiWei | int | 否 | 是否阿里企微 1-是 2-否 | |
||||||
|
| IsGraves | int | 否 | 是否Graves 1-是 2-否 3-不确定 | |
||||||
|
| HasTedSurgery | int | 否 | 是否TED手术 1-是 2-否 3-不确定 | |
||||||
|
| promotionMethodId | int | 否 | 推广方式Id | |
||||||
|
| isKnowTituyo | int | 否 | 是否知道替妥尤 | |
||||||
|
| isUseTituyo | int | 否 | 是否使用替妥尤 | |
||||||
|
| diseaseStage | int | 是(version) | 疾病分级 1-轻度 2-中重度 3-极重度 | |
||||||
|
| diseasePeriod | int | 是(version) | 疾病分期 1-活动期 2-非活动期 | |
||||||
|
| tituyo | array | 否 | 替妥尤使用情况 | |
||||||
|
| prescriptionImg | string | 否 | 处方图片 | |
||||||
|
| **FirstDiagnosisDate** | string | **是(version>=2.6.0)** | **首次确诊甲状腺眼病的日期，格式 YYYY-MM-DD** | |
||||||
|
| **IsRelapse** | int | **是(version>=2.6.0)** | **当前是否为复发 1-复发 2-新发** | |
||||||
|
| **CurrentTreatmentPlan** | int | **是(version>=2.6.0)** | **正在进行的治疗方案 1-激素治疗(口服、冲击治疗、局部注射) 2-激素+替妥尤序贯治疗(不同时使用) 3-激素+替妥尤联合治疗(同时使用) 4-单用替妥尤(无激素/无免疫抑制剂) 5-托珠单抗 6-其他生物制剂 7-其他** | |
||||||
|
| **PastTreatmentPlan** | string | **是(version>=2.6.0)** | **既往治疗方案，逗号分隔多选 1-口服激素 2-静脉激素冲击 3-局部注射激素 4-放疗 5-替妥尤单抗 6-托珠单抗 7-其他生物制剂 8-眶减压术 9-无** | |
||||||
|
| **TeprotumumabFirstInfusionDate** | string | 否 | **替妥尤首次输注时间，格式 YYYY-MM-DD。仅在有新数据时更新，不会因治疗方案变化而清空** | |
||||||
|
| **TeprotumumabInfusionCount** | int | 否 | **替妥尤已输注次数(入组时) 1-8具体次数 9表示>8。仅在有新数据时更新，不会因治疗方案变化而清空** | |
||||||
|
|
||||||
|
### 响应 |
||||||
|
|
||||||
|
```json |
||||||
|
{ |
||||||
|
"code": 0, |
||||||
|
"message": "操作成功", |
||||||
|
"data": "操作成功" |
||||||
|
} |
||||||
|
``` |
||||||
|
|
||||||
|
### 业务规则 |
||||||
|
|
||||||
|
- TeprotumumabFirstInfusionDate 和 TeprotumumabInfusionCount 如果有数据，仅通过接口更新数据，不会因为治疗方案选择了其他选项而删除 |
||||||
|
- 当 CurrentTreatmentPlan 为2/3/4 或 PastTreatmentPlan 包含5时，应展开替妥尤输注相关问题（前端逻辑） |
||||||
|
- version>=2.6.0 时，FirstDiagnosisDate、IsRelapse、CurrentTreatmentPlan、PastTreatmentPlan 为必填 |
||||||
|
|
||||||
|
--- |
||||||
|
|
||||||
|
## 2. 常量定义接口 account/dict |
||||||
|
|
||||||
|
**路由**: `?r=zd/account/dict` |
||||||
|
**方法**: GET |
||||||
|
**需要登录**: 否 |
||||||
|
|
||||||
|
返回V2.6.0新增字段的枚举选项列表，供前端渲染下拉/多选控件使用。 |
||||||
|
|
||||||
|
### 请求参数 |
||||||
|
|
||||||
|
无 |
||||||
|
|
||||||
|
### 响应 |
||||||
|
|
||||||
|
```json |
||||||
|
{ |
||||||
|
"code": 0, |
||||||
|
"message": "success", |
||||||
|
"data": { |
||||||
|
"IsRelapseList": [ |
||||||
|
{ "1": "复发", "2": "新发" } |
||||||
|
], |
||||||
|
"CurrentTreatmentPlanList": [ |
||||||
|
{ "1": "激素治疗（口服、冲击治疗、局部注射）", "2": "激素+替妥尤序贯治疗（不同时使用）", "3": "激素+替妥尤联合治疗（同时使用）", "4": "单用替妥尤（无激素/无免疫抑制剂）", "5": "托珠单抗", "6": "其他生物制剂", "7": "其他" } |
||||||
|
], |
||||||
|
"PastTreatmentPlanList": [ |
||||||
|
{ "1": "口服激素", "2": "静脉激素冲击", "3": "局部注射激素", "4": "放疗", "5": "替妥尤单抗", "6": "托珠单抗", "7": "其他生物制剂", "8": "眶减压术", "9": "无" } |
||||||
|
], |
||||||
|
"TeprotumumabInfusionCountList": [ |
||||||
|
{ "1": "1", "2": "2", "3": "3", "4": "4", "5": "5", "6": "6", "7": "7", "8": "8", "9": ">8" } |
||||||
|
] |
||||||
|
} |
||||||
|
} |
||||||
|
``` |
||||||
|
|
||||||
|
### 返回字段说明 |
||||||
|
|
||||||
|
| 字段名 | 类型 | 说明 | |
||||||
|
|---|---|---| |
||||||
|
| IsRelapseList | object | 当前是否为复发选项，key为值，value为含义 | |
||||||
|
| CurrentTreatmentPlanList | object | 正在进行的治疗方案选项，key为值，value为含义 | |
||||||
|
| PastTreatmentPlanList | object | 既往治疗方案选项（多选），key为值，value为含义，传入时以逗号分隔的key值组合 | |
||||||
|
| TeprotumumabInfusionCountList | object | 替妥尤已输注次数选项，key为值，value为含义，9表示>8 | |
||||||
|
|
||||||
|
--- |
||||||
|
|
||||||
|
## 3. 获取个人信息接口 account/info |
||||||
|
|
||||||
|
**路由**: `?r=zd/account/info` |
||||||
|
**方法**: GET |
||||||
|
**需要登录**: 是（systemUserId） |
||||||
|
|
||||||
|
### 请求参数 |
||||||
|
|
||||||
|
无额外参数，通过登录态获取用户信息。 |
||||||
|
|
||||||
|
### 响应 |
||||||
|
|
||||||
|
```json |
||||||
|
{ |
||||||
|
"code": 0, |
||||||
|
"message": "success", |
||||||
|
"data": { |
||||||
|
"UserId": "xxx", |
||||||
|
"PatientId": "xxx", |
||||||
|
"PatientName": "xxx", |
||||||
|
"AuditStatus": 3, |
||||||
|
"UserType": 3, |
||||||
|
"RelationType": 1, |
||||||
|
"UserImg": "xxx", |
||||||
|
"Telephone": "xxx", |
||||||
|
"EntryThreePeriod": 0, |
||||||
|
"MedicineAuditSwitch": "0", |
||||||
|
"has7DayAdl": 1, |
||||||
|
"isFollow": 1, |
||||||
|
"isShowFollowGuide": 2, |
||||||
|
"UserRegTime": "xxx", |
||||||
|
"AdlNotifySwitch": 1, |
||||||
|
"OpenTraining": 1, |
||||||
|
"IsRootUser": 1, |
||||||
|
"AgeYear": 30, |
||||||
|
"AgeMonth": 5, |
||||||
|
"Birth": "1995-05", |
||||||
|
"Gender": 1, |
||||||
|
"AgeRange": 3, |
||||||
|
"AntibodyType": 1, |
||||||
|
"ThyroidAbnormal": 1, |
||||||
|
"PreviousConvulsion": 2, |
||||||
|
"TraditionalImmunosuppressant": 1, |
||||||
|
"MedicalInsuranceType": 1, |
||||||
|
"DiagnosisTime": "2024-01", |
||||||
|
"DiagnoseType": 1, |
||||||
|
"DiagnoseImg": "xxx", |
||||||
|
"CommitTime": "xxx", |
||||||
|
"AuditStatus": 3, |
||||||
|
"RejectReason": "", |
||||||
|
"IsSick": 1, |
||||||
|
"PatientCanFollowUp": 1, |
||||||
|
"IsUseDrugs": 1, |
||||||
|
"IsKnowTituyo": 1, |
||||||
|
"IsUseTituyo": 2, |
||||||
|
"PrescriptionImg": "xxx", |
||||||
|
"DrugsAuditStatus": 3, |
||||||
|
"UseDrugsAuditStatus": 3, |
||||||
|
"UseDrugsAuditTime": "xxx", |
||||||
|
"UseDrugsRejectReason": "", |
||||||
|
"UseDrugsImg": "xxx", |
||||||
|
"UseDrugsCommitTime": "xxx", |
||||||
|
"JoinDays": 100, |
||||||
|
"IsGraves": 1, |
||||||
|
"HasTedSurgery": 2, |
||||||
|
"HasSelf": 1, |
||||||
|
"DiagnosisCertificate": "xxx", |
||||||
|
"InviteDoctorId": 1, |
||||||
|
"ExclusiveDoctorId": 1, |
||||||
|
"ExclusiveDoctorImg": "xxx", |
||||||
|
"ExclusiveDoctorName": "xxx", |
||||||
|
"ExclusiveDoctorHospitalId": 1, |
||||||
|
"ExclusiveDoctorHospitalName": "xxx", |
||||||
|
"ExclusiveDoctorHospitalClassification": 1, |
||||||
|
"ExclusiveDoctorHospitalClassificationName": "xxx", |
||||||
|
"ExclusiveDoctorHospitalLevel": 1, |
||||||
|
"ExclusiveDoctorHospitalLevelName": "xxx", |
||||||
|
"EntryTwoPeriod": 0, |
||||||
|
"EntryThreePeriod": 0, |
||||||
|
"DiseaseStage": 2, |
||||||
|
"DiseasePeriod": 1, |
||||||
|
"FirstDiagnosisDate": "2024-06-15", |
||||||
|
"IsRelapse": 1, |
||||||
|
"CurrentTreatmentPlan": 2, |
||||||
|
"PastTreatmentPlan": "1,2,5", |
||||||
|
"TeprotumumabFirstInfusionDate": "2025-03-20", |
||||||
|
"TeprotumumabInfusionCount": 4, |
||||||
|
"tituyo": [], |
||||||
|
"tituyoList": [] |
||||||
|
} |
||||||
|
} |
||||||
|
``` |
||||||
|
|
||||||
|
### V2.6.0 新增返回字段说明 |
||||||
|
|
||||||
|
| 字段名 | 类型 | 说明 | |
||||||
|
|---|---|---| |
||||||
|
| FirstDiagnosisDate | string | 首次确诊甲状腺眼病的日期，格式 YYYY-MM-DD | |
||||||
|
| IsRelapse | int | 当前是否为复发 1-复发 2-新发 | |
||||||
|
| CurrentTreatmentPlan | int | 正在进行的治疗方案 1-7 | |
||||||
|
| PastTreatmentPlan | string | 既往治疗方案，逗号分隔多选 1-9 | |
||||||
|
| TeprotumumabFirstInfusionDate | string | 替妥尤首次输注时间，格式 YYYY-MM-DD | |
||||||
|
| TeprotumumabInfusionCount | int | 替妥尤已输注次数(入组时) 1-8具体次数 9表示>8 | |
||||||
|
|
||||||
|
--- |
||||||
|
|
||||||
|
## 4. 患者列表接口 patient/list（后台） |
||||||
|
|
||||||
|
**路由**: `?r=family/patient/list` |
||||||
|
**方法**: GET |
||||||
|
**需要登录**: 是（后台管理端登录） |
||||||
|
|
||||||
|
### 请求参数 |
||||||
|
|
||||||
|
| 参数名 | 类型 | 必填 | 说明 | |
||||||
|
|---|---|---|---| |
||||||
|
| Search | string | 否 | 搜索关键词（患者姓名、医生姓名、PatientId、手机号） | |
||||||
|
| UserType | int | 否 | 用户类型 1-空白 2-注册 3-疾病 4-用药 | |
||||||
|
| DiagnoseType | int | 否 | 诊断类型 | |
||||||
|
| BecomePatientTimeBegin | string | 否 | 成为患者时间开始 | |
||||||
|
| BecomePatientTimeEnd | string | 否 | 成为患者时间结束 | |
||||||
|
| UseDrugsJoinTimeBegin | string | 否 | 用药时间开始 | |
||||||
|
| UseDrugsJoinTimeEnd | string | 否 | 用药时间结束 | |
||||||
|
| LastUseDrugsTimeBegin | string | 否 | 最近一次用药时间开始 | |
||||||
|
| LastUseDrugsTimeEnd | string | 否 | 最近一次用药时间结束 | |
||||||
|
| RegistChannel | int | 否 | 注册渠道 | |
||||||
|
| RegionLTwoId | int | 否 | 大分区筛选 | |
||||||
|
| TelephoneRegionId | int | 否 | 电话大区筛选 | |
||||||
|
| HospitalRegionLTwoId | int | 否 | 邀约大区筛选 | |
||||||
|
| HospitalRegionLThreeId | int | 否 | 邀约地区筛选 | |
||||||
|
| Sort | string | 否 | 排序字段 | |
||||||
|
| SamePatient | int | 否 | 相同患者筛选 | |
||||||
|
| InsuranceSuccessTimeBegin | string | 否 | 商保审核成功时间开始 | |
||||||
|
| InsuranceSuccessTimeEnd | string | 否 | 商保审核成功时间结束 | |
||||||
|
| InviteChannel | int | 否 | 邀约渠道 1-医生码 2-QOL | |
||||||
|
| InviteDoctorId | int | 否 | 邀约医生Id | |
||||||
|
| IsOpenNrdlActivity | int | 否 | 是否打开NRDL活动 | |
||||||
|
| count | int | 否 | 每页条数，默认10 | |
||||||
|
| UseDrugsDate | string | 否 | 用药日期 | |
||||||
|
| beijingFlag | int | 否 | 北京标识 | |
||||||
|
| shanghaiFlag | int | 否 | 上海标识 | |
||||||
|
| guangzhouFlag | int | 否 | 广州标识 | |
||||||
|
| guangdongFlag | int | 否 | 广东标识 | |
||||||
|
| IsAliQiWei | int | 否 | 是否阿里企微 1-是 2-否 | |
||||||
|
| promotionMethodId | int | 否 | 推广方式Id | |
||||||
|
| IsKnowTituyo | int | 否 | 是否知道替妥尤 | |
||||||
|
| IsUseTituyo | int | 否 | 是否使用替妥尤 | |
||||||
|
| **IsRelapse** | int | 否 | **当前是否为复发 1-复发 2-新发** | |
||||||
|
| **CurrentTreatmentPlan** | int | 否 | **正在进行的治疗方案 1-7** | |
||||||
|
|
||||||
|
### 响应 |
||||||
|
|
||||||
|
```json |
||||||
|
{ |
||||||
|
"code": 0, |
||||||
|
"message": "success", |
||||||
|
"data": { |
||||||
|
"list": [ |
||||||
|
{ |
||||||
|
"PatientId": 1, |
||||||
|
"Name": "xxx", |
||||||
|
"UserId": "xxx", |
||||||
|
"Telephone": "xxx", |
||||||
|
"RelationType": 1, |
||||||
|
"PromotionMethodId": 1, |
||||||
|
"AgeYear": 30, |
||||||
|
"AgeMonth": 5, |
||||||
|
"Gender": 1, |
||||||
|
"Avatar": "xxx", |
||||||
|
"DiagnoseType": 1, |
||||||
|
"BecomePatientTime": "xxx", |
||||||
|
"DiagnoseImg": "xxx", |
||||||
|
"UseDrugsJoinTime": "xxx", |
||||||
|
"ConversionDays": 10, |
||||||
|
"AdlNums": 5, |
||||||
|
"IsSick": 1, |
||||||
|
"IsUseDrugs": 1, |
||||||
|
"IsAliQiWei": 2, |
||||||
|
"LastAdlId": 1, |
||||||
|
"UseDrugsNum": 3, |
||||||
|
"LastUseDrugsTime": "xxx", |
||||||
|
"IsGraves": 1, |
||||||
|
"HasTedSurgery": 2, |
||||||
|
"IsKnowTituyo": 1, |
||||||
|
"IsUseTituyo": 2, |
||||||
|
"DiseaseStage": 2, |
||||||
|
"DiseasePeriod": 1, |
||||||
|
"FirstDiagnosisDate": "2024-06-15", |
||||||
|
"IsRelapse": 1, |
||||||
|
"CurrentTreatmentPlan": 2, |
||||||
|
"PastTreatmentPlan": "1,2,5", |
||||||
|
"TeprotumumabFirstInfusionDate": "2025-03-20", |
||||||
|
"TeprotumumabInfusionCount": 4, |
||||||
|
"IsRelapseName": "复发", |
||||||
|
"CurrentTreatmentPlanName": "激素+替妥尤序贯治疗（不同时使用）", |
||||||
|
"PastTreatmentPlanName": "口服激素,静脉激素冲击,替妥尤单抗", |
||||||
|
"TeprotumumabInfusionCountName": "4", |
||||||
|
"...": "其他字段" |
||||||
|
} |
||||||
|
], |
||||||
|
"pages": { "totalCount": 100, "pageCount": 10, "currentPage": 1, "perPage": 10 }, |
||||||
|
"count": 100, |
||||||
|
"page": 1, |
||||||
|
"AllPatient": 100, |
||||||
|
"NanPatient": 50, |
||||||
|
"NvPatient": 50, |
||||||
|
"SickPatient": 80, |
||||||
|
"UseDrugsPatient": 20 |
||||||
|
} |
||||||
|
} |
||||||
|
``` |
||||||
|
|
||||||
|
### V2.6.0 新增筛选条件说明 |
||||||
|
|
||||||
|
| 参数名 | 类型 | 说明 | |
||||||
|
|---|---|---| |
||||||
|
| IsRelapse | int | 筛选当前是否为复发 1-复发 2-新发 | |
||||||
|
| CurrentTreatmentPlan | int | 簿选正在进行的治疗方案 1-7 | |
||||||
|
|
||||||
|
### V2.6.0 新增返回字段说明 |
||||||
|
|
||||||
|
| 字段名 | 类型 | 说明 | |
||||||
|
|---|---|---| |
||||||
|
| FirstDiagnosisDate | string | 首次确诊甲状腺眼病的日期 YYYY-MM-DD | |
||||||
|
| IsRelapse | int | 当前是否为复发 1-复发 2-新发 | |
||||||
|
| IsRelapseName | string | 当前是否为复发的文本，如"复发"/"新发" | |
||||||
|
| CurrentTreatmentPlan | int | 正在进行的治疗方案 1-7 | |
||||||
|
| CurrentTreatmentPlanName | string | 正在进行的治疗方案的文本 | |
||||||
|
| PastTreatmentPlan | string | 既往治疗方案，逗号分隔多选 1-9 | |
||||||
|
| PastTreatmentPlanName | string | 既往治疗方案的文本，逗号分隔，如"口服激素,静脉激素冲击,替妥尤单抗" | |
||||||
|
| TeprotumumabFirstInfusionDate | string | 替妥尤首次输注时间 YYYY-MM-DD | |
||||||
|
| TeprotumumabInfusionCount | int | 替妥尤已输注次数(入组时) 1-8具体次数 9表示>8 | |
||||||
|
| TeprotumumabInfusionCountName | string | 替妥尤已输注次数的文本，9时显示">8" | |
||||||
|
|
||||||
|
--- |
||||||
|
|
||||||
|
## 附录：常量值域对照表 |
||||||
|
|
||||||
|
### IsRelapse - 当前是否为复发 |
||||||
|
|
||||||
|
| 值 | 含义 | |
||||||
|
|---|---| |
||||||
|
| 1 | 复发 | |
||||||
|
| 2 | 新发 | |
||||||
|
|
||||||
|
### CurrentTreatmentPlan - 正在进行的治疗方案 |
||||||
|
|
||||||
|
| 值 | 含义 | |
||||||
|
|---|---| |
||||||
|
| 1 | 激素治疗（口服、冲击治疗、局部注射） | |
||||||
|
| 2 | 激素+替妥尤序贯治疗（不同时使用） | |
||||||
|
| 3 | 激素+替妥尤联合治疗（同时使用） | |
||||||
|
| 4 | 单用替妥尤（无激素/无免疫抑制剂） | |
||||||
|
| 5 | 托珠单抗 | |
||||||
|
| 6 | 其他生物制剂 | |
||||||
|
| 7 | 其他 | |
||||||
|
|
||||||
|
### PastTreatmentPlan - 既往治疗方案（多选，逗号分隔存储） |
||||||
|
|
||||||
|
| 值 | 含义 | |
||||||
|
|---|---| |
||||||
|
| 1 | 口服激素 | |
||||||
|
| 2 | 静脉激素冲击 | |
||||||
|
| 3 | 局部注射激素 | |
||||||
|
| 4 | 放疗 | |
||||||
|
| 5 | 替妥尤单抗 | |
||||||
|
| 6 | 托珠单抗 | |
||||||
|
| 7 | 其他生物制剂 | |
||||||
|
| 8 | 眶减压术 | |
||||||
|
| 9 | 无 | |
||||||
|
|
||||||
|
### TeprotumumabInfusionCount - 替妥尤已输注次数(入组时) |
||||||
|
|
||||||
|
| 值 | 含义 | |
||||||
|
|---|---| |
||||||
|
| 1-8 | 具体输注次数 | |
||||||
|
| 9 | >8次 | |
||||||
Loading…
Reference in new issue