You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
384 lines
13 KiB
384 lines
13 KiB
2 weeks ago
|
# 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次 |
|