bindbox-game/docs/swagger.yaml
2025-10-16 13:28:24 +08:00

2589 lines
65 KiB
YAML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

basePath: /
definitions:
admin.loginRequest:
properties:
password:
description: 密码 (MD5加密后的密码)
type: string
username:
description: 用户名
type: string
required:
- password
- username
type: object
admin.loginResponse:
properties:
token:
description: 登录成功后颁发的 Token
type: string
type: object
admin.patientListData:
properties:
age:
description: 年龄
type: string
height_growth_curve_type:
description: 身高生长曲线类型(0:未知 1:轻度偏离 2:正常 3:重度偏离)
type: integer
id:
description: 编号
type: integer
mobile:
description: 账号
type: string
next_follow_date:
description: 下次随访时间
type: string
operative_date:
description: 胆道闭锁手术时间
type: string
postoperative_duration:
description: 术后时长
type: string
risk_type:
description: 风险类型(0:未知 1:低危 2:中危 3:高危)
type: integer
risk_value:
description: 风险值
type: string
sex:
description: 性别(0:未知 1:男 2:女)
type: integer
username:
description: 姓名
type: string
weight_growth_curve_type:
description: 体重生长曲线类型(0:未知 1:轻度偏离 2:正常 3:重度偏离)
type: integer
type: object
admin.patientListResponse:
properties:
list:
items:
$ref: '#/definitions/admin.patientListData'
type: array
page:
description: 当前页码
type: integer
page_size:
description: 每页返回的数据量
type: integer
total:
description: 符合查询条件的总记录数
type: integer
type: object
admin.policyTokenResponse:
properties:
token:
description: 临时访问凭证
type: string
type: object
article.createArticleRequest:
properties:
content:
description: 文章内容
type: string
cover_image:
description: 文章封面图
type: string
title:
description: 文章标题
type: string
required:
- content
- title
type: object
article.createArticleResponse:
properties:
message:
description: 提示信息
type: string
type: object
article.deleteArticleRequest:
properties:
ids:
description: 文章ID(多个用,分割)
type: string
required:
- ids
type: object
article.deleteArticleResponse:
properties:
message:
description: 提示信息
type: string
type: object
article.listData:
properties:
content:
description: 文章内容
type: string
cover_image:
description: 文章封面图
type: string
created_at:
description: 创建时间
type: string
id:
description: 文章编号
type: integer
title:
description: 文章标题
type: string
type: object
article.listResponse:
properties:
list:
items:
$ref: '#/definitions/article.listData'
type: array
page:
description: 当前页码
type: integer
page_size:
description: 每页返回的数据量
type: integer
total:
description: 符合查询条件的总记录数
type: integer
type: object
article.modifyArticleRequest:
properties:
content:
description: 文章内容
type: string
cover_image:
description: 文章封面图
type: string
title:
description: 文章标题
type: string
required:
- content
- title
type: object
article.modifyArticleResponse:
properties:
message:
description: 提示信息
type: string
type: object
code.Failure:
properties:
code:
description: 业务码
type: integer
message:
description: 描述信息
type: string
type: object
doctor.loginRequest:
properties:
mobile:
description: 手机号
type: string
password:
description: 密码 (MD5加密后的密码)
type: string
required:
- mobile
- password
type: object
doctor.loginResponse:
properties:
token:
description: 登录成功后颁发的 Token
type: string
type: object
doctor.patientListData:
properties:
age:
description: 年龄
type: string
avatar:
description: 头像
type: string
height_growth_curve_type:
description: 身高生长曲线类型(0:未知 1:轻度偏离 2:正常 3:重度偏离)
type: integer
id:
description: 编号
type: integer
mobile:
description: 账号
type: string
next_follow_date:
description: 下次随访时间
type: string
operative_date:
description: 胆道闭锁手术时间
type: string
postoperative_duration:
description: 术后时长
type: string
risk_type:
description: 风险类型(0:未知 1:低危 2:中危 3:高危)
type: integer
risk_value:
description: 风险值
type: string
sex:
description: 性别(0:未知 1:男 2:女)
type: integer
username:
description: 姓名
type: string
weight_growth_curve_type:
description: 体重生长曲线类型(0:未知 1:轻度偏离 2:正常 3:重度偏离)
type: integer
type: object
doctor.patientListResponse:
properties:
list:
items:
$ref: '#/definitions/doctor.patientListData'
type: array
page:
description: 当前页码
type: integer
page_size:
description: 每页返回的数据量
type: integer
total:
description: 符合查询条件的总记录数
type: integer
type: object
patient.agentInfoRequest:
properties:
source:
description: 来源(固定值:agent)
type: string
wx_user_id:
description: 微信用户ID
type: string
required:
- source
- wx_user_id
type: object
patient.agentInfoResponse:
properties:
basic_info:
allOf:
- $ref: '#/definitions/patient.basicInfo'
description: 基础信息
follow_plan_list:
description: 随访计划数据列表
items:
$ref: '#/definitions/patient.planList'
type: array
follow_questionnaire_list:
description: 随访问卷数据列表
items:
$ref: '#/definitions/patient.questionnaireDetailList'
type: array
type: object
patient.basicInfo:
properties:
age:
description: 年龄
type: string
avatar:
description: 头像
type: string
birth_number:
description: 产次(0:未知 1:1产 2:2产 3:≥3产)
type: integer
birth_weight:
description: 出生体重(克)
type: integer
birthday:
description: 出生日期(格式:2025-05-30)
type: string
conception_type:
description: 受孕方式(0:未知 1:自然受孕 2:辅助生殖技术)
type: integer
delivery_type:
description: 分娩方式(0:未知 1:顺产 2:剖宫产)
type: integer
gestational_week:
description: 孕周
type: integer
ggt_compared:
description: GGT 指数(较上次)
type: string
height_growth_curve_type:
description: 身高生长曲线类型(0:未知 1:轻度偏离 2:正常 3:重度偏离)
type: integer
id_number:
description: 身份证号
type: string
mobile:
description: 账号
type: string
next_follow_date:
description: 下次随访时间
type: string
operative_date:
description: 胆道闭锁手术时间
type: string
parity_number:
description: 胎次(0:未知 1:1胎 2:胎 3:胎 4:≥4胎)
type: integer
postoperative_duration:
description: 术后时长
type: string
prenatal_check_remark:
description: 产检异常描述
type: string
prenatal_check_type:
description: 产检是否异常(0:未知 1:有 2:无)
type: integer
risk_type:
description: 风险类型(0:未知 1:低危 2:中危 3:高危)
type: integer
risk_value:
description: 风险值
type: string
sex:
description: 性别(0:未知 1:男 2:女)
type: integer
username:
description: 姓名
type: string
weight_growth_curve_type:
description: 体重生长曲线类型(0:未知 1:轻度偏离 2:正常 3:重度偏离)
type: integer
type: object
patient.bindTagRequest:
properties:
wx_user_id:
description: 微信ID
type: string
required:
- wx_user_id
type: object
patient.bindTagResponse:
properties:
message:
description: 提示信息
type: string
type: object
patient.codeLoginRequest:
properties:
code:
description: 验证码
type: string
mobile:
description: 手机号
type: string
required:
- code
- mobile
type: object
patient.codeLoginResponse:
properties:
is_personal_information_complete:
description: 是否完善个人信息
type: boolean
token:
description: 登录成功后颁发的 Token
type: string
type: object
patient.diagnosticRequest:
properties:
day:
description: 日龄(天)
type: integer
gallbladder_image:
description: 胆囊照片
type: string
mmp_7:
description: MMP-7检测值
type: string
mobile:
description: 手机号
type: string
open_id:
description: 用户OPEN ID
type: string
portal_vein_branch_image:
description: 门静脉左右分支照片
type: string
portal_vein_cross_image:
description: 门静脉右支横截照片
type: string
user_id:
description: 用户ID(唯一ID)
type: string
username:
description: 姓名
type: string
required:
- day
- gallbladder_image
- mmp_7
- mobile
- portal_vein_branch_image
- portal_vein_cross_image
- username
type: object
patient.diagnosticResponse:
properties:
message:
description: 提示信息
type: string
mobile:
description: 手机号
type: string
open_id:
description: OPEN ID
type: string
user_id:
description: 用户ID(唯一ID)
type: string
username:
description: 姓名
type: string
type: object
patient.followPlanListData:
properties:
id:
description: 编号
type: integer
plan_date:
description: 计划日期
type: string
plan_name:
description: 计划名称
type: string
questionnaire_id:
description: 随访记录ID
type: integer
status:
description: 完成状态(1:未完成 2:已完成)
type: integer
type: object
patient.followPlanListResponse:
properties:
list:
items:
$ref: '#/definitions/patient.followPlanListData'
type: array
page:
description: 当前页码
type: integer
page_size:
description: 每页返回的数据量
type: integer
total:
description: 符合查询条件的总记录数
type: integer
type: object
patient.followQuestionnaireCreateRequest:
properties:
albumin:
description: 白蛋白g/L
type: string
alp:
description: ALPU/L
type: string
aptt:
description: APTTs
type: string
b_mode_image:
description: B超报告(多张用,分割)
type: string
blood_routine_image:
description: 血常规检查报告(多张用,分割)
type: string
coagulation_function_image:
description: 凝血功能检查报告(多张用,分割)
type: string
common_bile_duct:
description: 胆总管(mm)
type: string
crp:
description: CRPmg/L
type: string
ddr:
description: DDR
type: string
direct_bilirubin:
description: 直接胆红素(µmol/L)
type: string
elastography_maximum:
description: 弹性成像最大值(kPa)
type: string
elastography_median:
description: 弹性成像中位数(kPa)
type: string
elastography_minimum:
description: 弹性成像最小值(kPa)
type: string
fib:
description: FIBg/L
type: string
fiber_block_size:
description: 纤维块大小(mm)
type: string
follow_date:
description: 随访日期
type: string
follow_hospital:
description: 随访医院
type: string
follow_name:
description: 随访名称
type: string
gallbladder_size:
description: 胆囊大小(mm)
type: string
ggt:
description: GGTU/L
type: string
grain_grass:
description: 谷草U/L
type: string
gu_bing:
description: 谷丙U/L
type: string
head_circumference:
description: 头围(CM)
type: string
height:
description: 身高(CM)
type: string
hemoglobin:
description: 血红蛋白 (g/L)
type: string
high_hip:
description: 上臀围(CM)
type: string
inr:
description: INR
type: string
is_have_ascites:
description: 有无腹水(1:是 2:否)
type: integer
is_have_cyst:
description: 有无肝囊肿(1:是 2:否)
type: integer
liver_echo:
description: 肝回声
type: string
liver_elasticity_value:
description: 肝弹性值
type: string
liver_function_image:
description: 肝功能检查报告(多张用,分割)
type: string
main_portal_vein:
description: 门静脉主干内径(mm)
type: string
mdt_image:
description: MDT电子病历(多张用,分割)
type: string
mmp_7:
description: MMP-7ng/mL
type: string
npdp:
description: NPDPmg/L
type: string
nutritional_indicator_image:
description: 营养指标检查报告(多张用,分割)
type: string
oh_d:
description: 25OHD (ng/ml)
type: string
oh_d2:
description: 25OHD2 (ng/ml)
type: string
oh_d3:
description: 25OHD3 (ng/ml)
type: string
plan_id:
description: 随访计划ID
type: integer
platelets:
description: 血小板10^9/L)
type: string
pt:
description: PTs
type: string
pta:
description: PTA%
type: string
pvv:
description: 门静脉流速
type: string
questionnaire_id:
description: 随访记录ID(编辑时传递此值)
type: integer
red_blood_cells:
description: 红细胞 (10^9/L)
type: string
spleen_rib_area:
description: 脾肋下(mm)
type: string
total_bile_acid:
description: 总胆汁酸(g/L)
type: string
total_bilirubin:
description: 总胆红素(µmol/L)
type: string
tt:
description: TTs
type: string
under_the_liver_rib:
description: 肝肋下(mm)
type: string
under_the_xiphoid_liver:
description: 肝剑突下(mm)
type: string
vitamin_a:
description: 维生素A (ng/ml)
type: string
vitamin_e:
description: 维生素E (ng/ml)
type: string
vitamin_k:
description: 维生素K (ng/ml)
type: string
weight:
description: 体重(KG)
type: string
white_blood_cells:
description: 白细胞 (10^9/L)
type: string
required:
- follow_date
- follow_hospital
- follow_name
- height
- weight
type: object
patient.followQuestionnaireCreateResponse:
properties:
message:
description: 提示信息
type: string
type: object
patient.forgotPasswordRequest:
properties:
code:
description: 验证码
type: string
mobile:
description: 手机号
type: string
password:
description: 新密码 (MD5加密后的密码)
type: string
password2:
description: 确认密码 (MD5加密后的密码)
type: string
required:
- code
- mobile
- password
- password2
type: object
patient.forgotPasswordResponse:
properties:
message:
description: 提示信息
type: string
type: object
patient.listData:
properties:
content:
description: 文章内容
type: string
cover_image:
description: 文章封面图
type: string
created_at:
description: 创建时间
type: string
id:
description: 文章编号
type: integer
title:
description: 文章标题
type: string
type: object
patient.listResponse:
properties:
list:
items:
$ref: '#/definitions/patient.listData'
type: array
page:
description: 当前页码
type: integer
page_size:
description: 每页返回的数据量
type: integer
total:
description: 符合查询条件的总记录数
type: integer
type: object
patient.passwordLoginRequest:
properties:
mobile:
description: 手机号
type: string
password:
description: 密码 (MD5加密后的密码)
type: string
required:
- mobile
- password
type: object
patient.passwordLoginResponse:
properties:
is_personal_information_complete:
description: 是否完善个人信息
type: boolean
token:
description: 登录成功后颁发的 Token
type: string
type: object
patient.planList:
properties:
id:
description: 编号
type: integer
plan_date:
description: 计划日期
type: string
plan_name:
description: 计划名称
type: string
type: object
patient.questionnaireDetailList:
properties:
albumin:
description: 白蛋白g/L
type: string
alp:
description: ALPU/L
type: string
aptt:
description: APTTs
type: string
b_mode_image:
description: B超报告(多张用,分割)
type: string
blood_routine_image:
description: 血常规检查报告(多张用,分割)
type: string
coagulation_function_image:
description: 凝血功能检查报告(多张用,分割)
type: string
common_bile_duct:
description: 胆总管(mm)
type: string
crp:
description: CRPmg/L
type: string
ddr:
description: DDR
type: string
direct_bilirubin:
description: 直接胆红素(µmol/L)
type: string
elastography_maximum:
description: 弹性成像最大值(kPa)
type: string
elastography_median:
description: 弹性成像中位数(kPa)
type: string
elastography_minimum:
description: 弹性成像最小值(kPa)
type: string
fib:
description: FIBg/L
type: string
fiber_block_size:
description: 纤维块大小(mm)
type: string
follow_date:
description: 随访日期
type: string
follow_hospital:
description: 随访医院
type: string
follow_name:
description: 随访名称
type: string
gallbladder_size:
description: 胆囊大小(mm)
type: string
ggt:
description: GGTU/L
type: string
grain_grass:
description: 谷草U/L
type: string
gu_bing:
description: 谷丙U/L
type: string
head_circumference:
description: 头围(CM)
type: string
height:
description: 身高(CM)
type: string
hemoglobin:
description: 血红蛋白 (g/L)
type: string
high_hip:
description: 上臀围(CM)
type: string
id:
description: 随访记录ID
type: integer
inr:
description: INR
type: string
is_have_ascites:
description: 有无腹水(1:是 2:否)
type: integer
is_have_cyst:
description: 有无肝囊肿(1:是 2:否)
type: integer
liver_echo:
description: 肝回声
type: string
liver_elasticity_value:
description: 肝弹性值
type: string
liver_function_image:
description: 肝功能检查报告(多张用,分割)
type: string
main_portal_vein:
description: 门静脉主干内径(mm)
type: string
mdt_image:
description: MDT电子病历(多张用,分割)
type: string
mmp_7:
description: MMP-7ng/mL
type: string
npdp:
description: NPDPmg/L
type: string
nutritional_indicator_image:
description: 营养指标检查报告(多张用,分割)
type: string
oh_d:
description: 25OHD (ng/ml)
type: string
oh_d2:
description: 25OHD2 (ng/ml)
type: string
oh_d3:
description: 25OHD3 (ng/ml)
type: string
platelets:
description: 血小板10^9/L)
type: string
pt:
description: PTs
type: string
pta:
description: PTA%
type: string
pvv:
description: 门静脉流速
type: string
red_blood_cells:
description: 红细胞 (10^9/L)
type: string
spleen_rib_area:
description: 脾肋下(mm)
type: string
total_bile_acid:
description: 总胆汁酸(g/L)
type: string
total_bilirubin:
description: 总胆红素(µmol/L)
type: string
tt:
description: TTs
type: string
under_the_liver_rib:
description: 肝肋下(mm)
type: string
under_the_xiphoid_liver:
description: 肝剑突下(mm)
type: string
vitamin_a:
description: 维生素A (ng/ml)
type: string
vitamin_e:
description: 维生素E (ng/ml)
type: string
vitamin_k:
description: 维生素K (ng/ml)
type: string
weight:
description: 体重(KG)
type: string
white_blood_cells:
description: 白细胞 (10^9/L)
type: string
type: object
patient.questionnaireInfoRequest:
properties:
patient_id:
description: 患者ID
type: integer
questionnaire_id:
description: 随访问卷ID
type: integer
required:
- questionnaire_id
type: object
patient.quickLoginRequest:
properties:
code:
description: 动态令牌
type: string
required:
- code
type: object
patient.schemeCreateRequest:
properties:
detail:
description: 药品详情(JSON格式)
type: string
end_date:
description: 结束日期(格式:2025-05-30)
type: string
reminder:
description: 提醒时间(JSON格式)
type: string
start_date:
description: 开始日期(格式:2025-05-30)
type: string
required:
- detail
- end_date
- reminder
- start_date
type: object
patient.schemeCreateResponse:
properties:
message:
description: 提示信息
type: string
type: object
patient.schemeListData:
properties:
detail:
description: 药品信息(JSON格式)
type: string
end_date:
description: 用药结束日期
type: string
id:
description: 编号
type: integer
reminder:
description: 用药提醒(JSON格式)
type: string
start_date:
description: 用药开始日期
type: string
type: object
patient.schemeListResponse:
properties:
list:
items:
$ref: '#/definitions/patient.schemeListData'
type: array
page:
description: 当前页码
type: integer
page_size:
description: 每页返回的数据量
type: integer
total:
description: 符合查询条件的总记录数
type: integer
type: object
patient.schemeRecodeListRequest:
properties:
page:
description: 当前页码,默认为第一页
type: integer
page_size:
description: 每页返回的数据量
type: integer
status:
description: 打卡状态(0:不限 1:未完成 2:已完成)
type: integer
time_type:
description: 时间类型(1:今天 2:近7天 3:近30天 4:近90天)
type: integer
required:
- time_type
type: object
patient.schemeRecordModifyResponse:
properties:
message:
description: 提示信息
type: string
type: object
patient.searchRequest:
properties:
mobile:
description: 手机号
type: string
open_id:
description: OPEN ID
type: string
user_id:
description: 用户ID(唯一ID)
type: string
username:
description: 姓名
type: string
required:
- mobile
- user_id
- username
type: object
patient.searchResponse:
properties:
message:
description: 提示信息
type: string
success:
description: 查询结果成功与否
type: boolean
type: object
patient.sendCodeRequest:
properties:
mobile:
description: 手机号
type: string
type:
description: 验证码类型(1:登录场景 2:忘记密码场景)
type: integer
required:
- mobile
- type
type: object
patient.sendCodeResponse:
properties:
message:
description: 提示信息
type: string
type: object
patient.setPersonalInformationRequest:
properties:
avatar:
description: 头像
type: string
birth_number:
description: 产次(0:未知 1:1产 2:2产 3:≥3产)
type: integer
birth_weight:
description: 出生体重(克)
type: integer
birthday:
description: 出生日期(格式:2025-05-30)
type: string
conception_type:
description: 受孕方式(0:未知 1:自然受孕 2:辅助生殖技术)
type: integer
delivery_type:
description: 分娩方式(0:未知 1:顺产 2:剖宫产)
type: integer
gestational_week:
description: 孕周
type: integer
id_number:
description: 身份证号
type: string
operative_date:
description: 手术日期(格式:2025-05-30)
type: string
parity_number:
description: 胎次(0:未知 1:1胎 2:胎 3:胎 4:≥4胎)
type: integer
prenatal_check_remark:
description: 产检异常描述
type: string
prenatal_check_type:
description: 产检是否异常(0:未知 1:有 2:无)
type: integer
sex:
description: 性别(1:男 2:女)
type: integer
username:
description: 姓名
type: string
required:
- birth_number
- birth_weight
- birthday
- conception_type
- delivery_type
- gestational_week
- operative_date
- parity_number
- prenatal_check_type
- sex
- username
type: object
patient.setPersonalInformationResponse:
properties:
message:
description: 提示信息
type: string
type: object
patient.symptomListData:
properties:
description:
description: 描述
type: string
id:
description: 编号
type: integer
title:
description: 症状
type: string
type: object
patient.symptomListResponse:
properties:
list:
items:
$ref: '#/definitions/patient.symptomListData'
type: array
type: object
patient.symptomSubmitRequest:
properties:
detail:
description: 症状详情
type: string
required:
- detail
type: object
patient.symptomSubmitResponse:
properties:
message:
description: 提示信息
type: string
type: object
service_patient.BasicInfoResponse:
properties:
age:
description: 年龄
type: string
avatar:
description: 头像
type: string
birth_number:
description: 产次(0:未知 1:1产 2:2产 3:≥3产)
type: integer
birth_weight:
description: 出生体重(克)
type: integer
birthday:
description: 出生日期(格式:2025-05-30)
type: string
conception_type:
description: 受孕方式(0:未知 1:自然受孕 2:辅助生殖技术)
type: integer
delivery_type:
description: 分娩方式(0:未知 1:顺产 2:剖宫产)
type: integer
gestational_week:
description: 孕周
type: integer
ggt_compared:
description: GGT 指数(较上次)
type: string
height_growth_curve_type:
description: 身高生长曲线类型(0:未知 1:轻度偏离 2:正常 3:重度偏离)
type: integer
id_number:
description: 身份证号
type: string
mobile:
description: 账号
type: string
next_follow_date:
description: 下次随访时间
type: string
operative_date:
description: 胆道闭锁手术时间
type: string
parity_number:
description: 胎次(0:未知 1:1胎 2:胎 3:胎 4:≥4胎)
type: integer
postoperative_duration:
description: 术后时长
type: string
prenatal_check_remark:
description: 产检异常描述
type: string
prenatal_check_type:
description: 产检是否异常(0:未知 1:有 2:无)
type: integer
risk_type:
description: 风险类型(0:未知 1:低危 2:中危 3:高危)
type: integer
risk_value:
description: 风险值
type: string
sex:
description: 性别(0:未知 1:男 2:女)
type: integer
username:
description: 姓名
type: string
weight_growth_curve_type:
description: 体重生长曲线类型(0:未知 1:轻度偏离 2:正常 3:重度偏离)
type: integer
type: object
service_patient.ChatListResponse:
properties:
list:
items:
$ref: '#/definitions/service_patient.chatListData'
type: array
type: object
service_patient.QuestionnaireDetailResponse:
properties:
albumin:
description: 白蛋白g/L
type: string
alp:
description: ALPU/L
type: string
aptt:
description: APTTs
type: string
b_mode_image:
description: B超报告(多张用,分割)
type: string
blood_routine_image:
description: 血常规检查报告(多张用,分割)
type: string
coagulation_function_image:
description: 凝血功能检查报告(多张用,分割)
type: string
common_bile_duct:
description: 胆总管(mm)
type: string
crp:
description: CRPmg/L
type: string
ddr:
description: DDR
type: string
direct_bilirubin:
description: 直接胆红素(µmol/L)
type: string
elastography_maximum:
description: 弹性成像最大值(kPa)
type: string
elastography_median:
description: 弹性成像中位数(kPa)
type: string
elastography_minimum:
description: 弹性成像最小值(kPa)
type: string
fib:
description: FIBg/L
type: string
fiber_block_size:
description: 纤维块大小(mm)
type: string
follow_date:
description: 随访日期
type: string
follow_hospital:
description: 随访医院
type: string
follow_name:
description: 随访名称
type: string
gallbladder_size:
description: 胆囊大小(mm)
type: string
ggt:
description: GGTU/L
type: string
grain_grass:
description: 谷草U/L
type: string
gu_bing:
description: 谷丙U/L
type: string
head_circumference:
description: 头围(CM)
type: string
height:
description: 身高(CM)
type: string
hemoglobin:
description: 血红蛋白 (g/L)
type: string
high_hip:
description: 上臀围(CM)
type: string
id:
description: 随访记录ID
type: integer
inr:
description: INR
type: string
is_have_ascites:
description: 有无腹水(1:是 2:否)
type: integer
is_have_cyst:
description: 有无肝囊肿(1:是 2:否)
type: integer
liver_echo:
description: 肝回声
type: string
liver_elasticity_value:
description: 肝弹性值
type: string
liver_function_image:
description: 肝功能检查报告(多张用,分割)
type: string
main_portal_vein:
description: 门静脉主干内径(mm)
type: string
mdt_image:
description: MDT电子病历(多张用,分割)
type: string
mmp_7:
description: MMP-7ng/mL
type: string
npdp:
description: NPDPmg/L
type: string
nutritional_indicator_image:
description: 营养指标检查报告(多张用,分割)
type: string
oh_d:
description: 25OHD (ng/ml)
type: string
oh_d2:
description: 25OHD2 (ng/ml)
type: string
oh_d3:
description: 25OHD3 (ng/ml)
type: string
platelets:
description: 血小板10^9/L)
type: string
pt:
description: PTs
type: string
pta:
description: PTA%
type: string
pvv:
description: 门静脉流速
type: string
red_blood_cells:
description: 红细胞 (10^9/L)
type: string
spleen_rib_area:
description: 脾肋下(mm)
type: string
total_bile_acid:
description: 总胆汁酸(g/L)
type: string
total_bilirubin:
description: 总胆红素(µmol/L)
type: string
tt:
description: TTs
type: string
under_the_liver_rib:
description: 肝肋下(mm)
type: string
under_the_xiphoid_liver:
description: 肝剑突下(mm)
type: string
vitamin_a:
description: 维生素A (ng/ml)
type: string
vitamin_e:
description: 维生素E (ng/ml)
type: string
vitamin_k:
description: 维生素K (ng/ml)
type: string
weight:
description: 体重(KG)
type: string
white_blood_cells:
description: 白细胞 (10^9/L)
type: string
type: object
service_patient.QuestionnaireListResponse:
properties:
list:
items:
$ref: '#/definitions/service_patient.questionnaireListData'
type: array
type: object
service_patient.chatListData:
properties:
age:
description: 年龄
type: string
direct_bilirubin:
description: 直接胆红素(µmol/L)
type: string
follow_date:
description: 随访日期
type: string
height:
description: 身高(CM)
type: string
id:
type: integer
total_bilirubin:
description: 总胆红素(µmol/L)
type: string
weight:
description: 体重(KG)
type: string
type: object
service_patient.questionnaireListData:
properties:
follow_date:
description: 随访日期
type: string
follow_hospital:
description: 随访医院
type: string
follow_name:
description: 随访名称
type: string
id:
description: 编号
type: integer
type: object
info:
contact: {}
title: mini-chat 接口文档
version: v0.0.1
paths:
/admin/article/{id}:
put:
consumes:
- application/json
description: 编辑文章
parameters:
- description: 编号ID
in: path
name: id
required: true
type: string
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/article.modifyArticleRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/article.modifyArticleResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 编辑文章
tags:
- 管理端.患教文章
/admin/article/create:
post:
consumes:
- application/json
description: 新增文章
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/article.createArticleRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/article.createArticleResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 新增文章
tags:
- 管理端.患教文章
/admin/article/delete:
post:
consumes:
- application/json
description: 删除文章
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/article.deleteArticleRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/article.deleteArticleResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 删除文章
tags:
- 管理端.患教文章
/admin/articles:
get:
consumes:
- application/json
description: 文章列表
parameters:
- description: 文章标题
in: query
name: title
type: string
- description: 开始时间
in: query
name: start_time
type: string
- description: 结束时间
in: query
name: end_time
type: string
- default: 1
description: 当前页码
in: query
name: page
required: true
type: integer
- default: 20
description: 每页返回的数据量,最多 100 条
in: query
name: page_size
required: true
type: integer
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/article.listResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 文章列表
tags:
- 管理端.患教文章
/admin/form_policy_token:
post:
consumes:
- application/json
description: Form 临时访问凭证
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/admin.policyTokenResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
summary: Form 临时访问凭证
tags:
- 管理端.临时访问凭证
/admin/login:
post:
consumes:
- application/json
description: 管理员登录
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/admin.loginRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/admin.loginResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
summary: 管理员登录
tags:
- 管理端.登录
/admin/patients:
get:
consumes:
- application/json
description: 患者列表
parameters:
- description: 姓名
in: query
name: username
type: string
- description: 账号
in: query
name: mobile
type: string
- description: 胆道闭锁手术时间(格式:2025-06-06)
in: query
name: operative_date
type: string
- description: 胆道闭锁手术开始时间(格式:2025-06-06)
in: query
name: operative_date_start
type: string
- description: 胆道闭锁结束结束时间(格式:2025-06-06)
in: query
name: operative_date_end
type: string
- description: 下次回访时间(格式:2025-06-06)
in: query
name: next_follow_date
type: string
- description: 下次回访开始时间(格式:2025-06-06)
in: query
name: next_follow_date_start
type: string
- description: 下次回访结束时间(格式:2025-06-06)
in: query
name: next_follow_date_end
type: string
- description: 风险类型(0:未知 1:低危 2:中危 3:高危)
in: query
name: risk_type
type: integer
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/admin.patientListResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 患者列表
tags:
- 管理端.患者管理
/admin/patients/export:
get:
consumes:
- application/json
description: 导出患者列表
parameters:
- description: 姓名
in: query
name: username
type: string
- description: 账号
in: query
name: mobile
type: string
- description: 胆道闭锁手术时间(格式:2025-06-06)
in: query
name: operative_date
type: string
- description: 胆道闭锁手术开始时间(格式:2025-06-06)
in: query
name: operative_date_start
type: string
- description: 胆道闭锁结束结束时间(格式:2025-06-06)
in: query
name: operative_date_end
type: string
- description: 下次回访时间(格式:2025-06-06)
in: query
name: next_follow_date
type: string
- description: 下次回访开始时间(格式:2025-06-06)
in: query
name: next_follow_date_start
type: string
- description: 下次回访结束时间(格式:2025-06-06)
in: query
name: next_follow_date_end
type: string
- description: 风险类型(0:未知 1:低危 2:中危 3:高危)
in: query
name: risk_type
type: integer
- default: 1
description: 当前页码
in: query
name: page
required: true
type: integer
- default: 20
description: 每页返回的数据量,最多 100 条
in: query
name: page_size
required: true
type: integer
produces:
- application/ms-excel
responses:
"200":
description: OK
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 导出患者列表
tags:
- 管理端.患者管理
/admin/policy_token:
post:
consumes:
- application/json
description: 临时访问凭证
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/admin.policyTokenResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
summary: 临时访问凭证
tags:
- 管理端.临时访问凭证
/doctor/login:
post:
consumes:
- application/json
description: 医生登录
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/doctor.loginRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/doctor.loginResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
summary: 医生登录
tags:
- 医生端.登录
/doctor/patients:
get:
consumes:
- application/json
description: 患者列表
parameters:
- description: 姓名
in: query
name: username
type: string
- description: 账号
in: query
name: mobile
type: string
- description: 胆道闭锁手术时间(格式:2025-06-06)
in: query
name: operative_date
type: string
- description: 下次回访时间(格式:2025-06-06)
in: query
name: next_follow_date
type: string
- description: 风险类型(0:未知 1:低危 2:中危 3:高危)
in: query
name: risk_type
type: integer
- default: 1
description: 当前页码
in: query
name: page
required: true
type: integer
- default: 20
description: 每页返回的数据量,最多 100 条
in: query
name: page_size
required: true
type: integer
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/doctor.patientListResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 患者列表
tags:
- 医生端.患者列表
/patient/articles:
get:
consumes:
- application/json
description: 健康教育文章列表
parameters:
- description: 文章标题
in: query
name: title
type: string
- default: 1
description: 当前页码
in: query
name: page
required: true
type: integer
- default: 20
description: 每页返回的数据量,最多 100 条
in: query
name: page_size
required: true
type: integer
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.listResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 健康教育文章列表
tags:
- 患者端.我的.健康教育
/patient/basic/{id}:
get:
consumes:
- application/json
description: 基本信息
parameters:
- description: 患者编号ID
in: path
name: id
required: true
type: string
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/service_patient.BasicInfoResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 基本信息
tags:
- 患者端.患者信息【通用】
/patient/bind_tag:
post:
consumes:
- application/json
description: 设置手术时间标签
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.bindTagRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.bindTagResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 设置手术时间标签
tags:
- 患者端.SCRM
/patient/chat/{id}:
get:
consumes:
- application/json
description: 图表数据列表
parameters:
- description: 患者编号ID
in: path
name: id
required: true
type: string
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/service_patient.ChatListResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 图表数据列表
tags:
- 患者端.患者信息【通用】
/patient/code_login:
post:
consumes:
- application/json
description: 患者验证码登录
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.codeLoginRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.codeLoginResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
summary: 患者验证码登录
tags:
- 患者端.登录
/patient/diagnostic:
post:
consumes:
- application/json
description: 诊断信息录入
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.diagnosticRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.diagnosticResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
summary: 诊断信息录入
tags:
- 患者端.诊断信息录入
/patient/diagnostic/search:
post:
consumes:
- application/json
description: 查询诊断结果
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.searchRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.searchResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
summary: 查询诊断结果
tags:
- 患者端.诊断信息录入
/patient/follow_plans:
get:
consumes:
- application/json
description: 随访计划列表
parameters:
- description: 数据类型(1:当前时间之后的随访计划 2:全部的随访计划)
in: query
name: type
required: true
type: integer
- default: 1
description: 当前页码
in: query
name: page
required: true
type: integer
- default: 20
description: 每页返回的数据量,最多 100 条
in: query
name: page_size
required: true
type: integer
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.followPlanListResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 随访计划列表
tags:
- 患者端.首页.随访
/patient/follow_questionnaire:
post:
consumes:
- application/json
description: 填写随访问卷
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.followQuestionnaireCreateRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.followQuestionnaireCreateResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 填写随访问卷
tags:
- 患者端.首页.随访
/patient/forgot_password:
post:
consumes:
- application/json
description: 忘记密码
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.forgotPasswordRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.forgotPasswordResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
summary: 忘记密码
tags:
- 患者端.登录
/patient/info:
post:
consumes:
- application/json
description: 智能体信息
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.agentInfoRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.agentInfoResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
summary: 智能体信息
tags:
- 患者端.患者信息【智能体】
/patient/medicine_record/{id}:
put:
consumes:
- application/json
description: 服药打卡
parameters:
- description: 编号ID
in: path
name: id
required: true
type: string
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.schemeRecordModifyResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 服药打卡
tags:
- 患者端.首页.服药打卡
/patient/medicine_records:
get:
consumes:
- application/json
description: 服药记录列表
parameters:
- description: 时间类型(1:今天 2:近7天 3:近30天 4:近90天)
in: query
name: time_type
required: true
type: integer
- description: 打卡状态(0:不限 1:未完成 2:已完成)
in: query
name: status
type: integer
- default: 1
description: 当前页码
in: query
name: page
required: true
type: integer
- default: 20
description: 每页返回的数据量,最多 100 条
in: query
name: page_size
required: true
type: integer
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.schemeRecodeListRequest'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 服药记录列表
tags:
- 患者端.首页.服药打卡
/patient/medicine_scheme:
post:
consumes:
- application/json
description: 新增用药方案
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.schemeCreateRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.schemeCreateResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 新增用药方案
tags:
- 患者端.我的.用药方案
/patient/medicine_scheme/{id}:
put:
consumes:
- application/json
description: 编辑用药方案
parameters:
- description: 编号ID
in: path
name: id
required: true
type: string
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.schemeCreateRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.schemeCreateResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 编辑用药方案
tags:
- 患者端.我的.用药方案
/patient/medicine_schemes:
get:
consumes:
- application/json
description: 用药方案列表
parameters:
- default: 1
description: 当前页码
in: query
name: page
required: true
type: integer
- default: 20
description: 每页返回的数据量,最多 100 条
in: query
name: page_size
required: true
type: integer
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.schemeListResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 用药方案列表
tags:
- 患者端.我的.用药方案
/patient/password_login:
post:
consumes:
- application/json
description: 患者密码登录
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.passwordLoginRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.passwordLoginResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
summary: 患者密码登录
tags:
- 患者端.登录
/patient/questionnaire_info:
post:
consumes:
- application/json
description: 随访问卷详情
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.questionnaireInfoRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/service_patient.QuestionnaireDetailResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 随访问卷详情
tags:
- 患者端.患者信息【通用】
/patient/questionnaires/{id}:
get:
consumes:
- application/json
description: 随访问卷列表
parameters:
- description: 患者编号ID
in: path
name: id
required: true
type: string
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/service_patient.QuestionnaireListResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 随访问卷列表
tags:
- 患者端.患者信息【通用】
/patient/quick_login:
post:
consumes:
- application/json
description: 手机号快捷登录
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.quickLoginRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.codeLoginResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
summary: 手机号快捷登录
tags:
- 患者端.登录
/patient/send_code:
post:
consumes:
- application/json
description: 发送验证码
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.sendCodeRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.sendCodeResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
summary: 发送验证码
tags:
- 患者端.登录
/patient/set_personal_information:
get:
consumes:
- application/json
description: 设置个人信息
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.setPersonalInformationRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.setPersonalInformationResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 设置个人信息
tags:
- 患者端.登录
/patient/symptom/submit:
post:
consumes:
- application/json
description: 症状自检提交
parameters:
- description: 请求参数
in: body
name: RequestBody
required: true
schema:
$ref: '#/definitions/patient.symptomSubmitRequest'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.symptomSubmitResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 症状自检提交
tags:
- 患者端.紧急通道.症状自检
/patient/symptoms:
get:
consumes:
- application/json
description: 症状列表
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/patient.symptomListResponse'
"400":
description: Bad Request
schema:
$ref: '#/definitions/code.Failure'
security:
- LoginVerifyToken: []
summary: 症状列表
tags:
- 患者端.紧急通道.症状自检
securityDefinitions:
LoginVerifyToken:
in: header
name: Authorization
type: apiKey
swagger: "2.0"