master

分支 (1)

管理

管理

master

doctor-api-backend
/
api_test.http

### 环境变量设置
# 服务器基础URL，根据实际部署环境修改
@baseUrl = http://localhost:8080
# API版本号，从配置文件读取
@apiVersion = v1
# JWT认证令牌，登录后获取并替换
@token =
#  eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VySUQiOjAsImlzcyI6ImRvY3Rvcl9hcGlfYmFja2VuZCIsImV4cCI6MTc0MTMxNTc2NiwiaWF0IjoxNzQxMjI5MzY2fQ.jWQYqkIHqoHmytz2pA_yNFUNUEIA0VgQPtmSoiqO53s

# eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VySUQiOjAsImlzcyI6ImRvY3Rvcl9hcGlfYmFja2VuZCIsImV4cCI6MTc0MTMxNTc2NiwiaWF0IjoxNzQxMjI5MzY2fQ.jWQYqkIHqoHmytz2pA_yNFUNUEIA0VgQPtmSoiqO53s
### 使用说明
1. 获取token：
   - 使用登录接口（1.1 用户登录）获取token
   - 登录成功后，响应中会包含token
   - 将获取到的token替换到上面的@token变量中

2. 测试其他接口：
   - 替换token后，即可测试其他需要认证的接口
   - 所有需要认证的接口都会自动使用@token变量


### 1. 用户认证相关接口

#### 1.1 用户注册
# 用户注册接口
# 请求方式：POST
# 请求路径：/api/v1/register
# 请求体：JSON格式，包含用户名和密码
POST {{baseUrl}}/api/{{apiVersion}}/register
Content-Type: application/json

{
    "username": "testuser",
    "password": "333333",
    "phone": "13801138000"
}

#### 1.2 用户登录
# 用户登录接口
# 请求方式：POST
# 请求路径：/api/v1/login
# 请求体：JSON格式，包含用户名和密码
POST {{baseUrl}}/api/{{apiVersion}}/login
Content-Type: application/json

{
    "username": "testuser",
    "password": "333333",
    "phone": "13800138000"
}

#### 1.3 用户退出登录
# 用户退出登录接口
# 请求方式：POST
# 请求路径：/api/v1/users/logout
# 请求头：需要携带token
POST {{baseUrl}}/api/{{apiVersion}}/logout
Authorization: Bearer {{token}}


### 3. 医生管理接口

#### 3.1 获取所有医生列表
# 获取所有医生信息列表
# 请求方式：GET
# 请求路径：/api/v1/doctors
# 请求头：需要携带token
GET {{baseUrl}}/api/{{apiVersion}}/doctors
Authorization: Bearer {{token}}

#### 3.2 获取单个医生信息
# 获取指定ID的医生信息
# 请求方式：GET
# 请求路径：/api/v1/doctors/:id
# 请求头：需要携带token
GET {{baseUrl}}/api/{{apiVersion}}/doctors/1
Authorization: Bearer {{token}}

#### 3.3 创建新医生
# 创建新的医生信息
# 请求方式：POST
# 请求路径：/api/v1/doctors
# 请求头：需要携带token和Content-Type
POST {{baseUrl}}/api/{{apiVersion}}/doctors
Content-Type: application/json
Authorization: Bearer {{token}}

{
    "name": "张医生",
    "specialty": "内科",
    "title": "主任医师",
    "department": "内科",
    "phone": "13800138000",
    "email": "zhangsan@example.com",
    "address": "北京市朝阳区",
    "id_card": "110101199001011234",
    "gender": "男",
    "birth_date": "1990-01-01"
}

#### 3.4 更新医生信息
# 更新指定ID的医生信息
# 请求方式：PUT
# 请求路径：/api/v1/doctors/:id
# 请求头：需要携带token和Content-Type
PUT {{baseUrl}}/api/{{apiVersion}}/doctors/1
Content-Type: application/json
Authorization: Bearer {{token}}

{
    "name": "张医生",
    "specialty": "外科",
    "title": "主任医师",
    "department": "外科"
}

#### 3.5 删除医生
# 删除指定ID的医生
# 请求方式：DELETE
# 请求路径：/api/v1/doctors/:id
# 请求头：需要携带token
DELETE {{baseUrl}}/api/{{apiVersion}}/doctors/1
Authorization: Bearer {{token}}

### 4. 患者管理接口

#### 4.1 获取所有患者列表
# 获取所有患者信息列表
# 请求方式：GET
# 请求路径：/api/v1/patients
# 请求头：需要携带token
GET {{baseUrl}}/api/{{apiVersion}}/patients
Authorization: Bearer {{token}}

#### 4.2 获取单个患者信息
# 获取指定ID的患者信息
# 请求方式：GET
# 请求路径：/api/v1/patients/:id
# 请求头：需要携带token
GET {{baseUrl}}/api/{{apiVersion}}/patients/1
Authorization: Bearer {{token}}

#### 4.3 创建新患者
# 创建新的患者信息
# 请求方式：POST
# 请求路径：/api/v1/patients
# 请求头：需要携带token和Content-Type
POST {{baseUrl}}/api/{{apiVersion}}/patients
Content-Type: application/json
Authorization: Bearer {{token}}

{
    "name": "张三",
    "gender": "男",
    "birth_date": "1990-01-01",
    "phone": "13800138000",
    "address": "北京市朝阳区",
    "id_card": "110101199001011234"
}

#### 4.4 更新患者信息
# 更新指定ID的患者信息
# 请求方式：PUT
# 请求路径：/api/v1/patients/:id
# 请求头：需要携带token和Content-Type
PUT {{baseUrl}}/api/{{apiVersion}}/patients/1
Content-Type: application/json
Authorization: Bearer {{token}}

{
    "name": "张三",
    "gender": "男",
    "birth_date": "1990-01-01",
    "phone": "13800138001",
    "address": "北京市海淀区",
    "id_card": "110101199001011234"
}

#### 4.5 删除患者
# 删除指定ID的患者
# 请求方式：DELETE
# 请求路径：/api/v1/patients/:id
# 请求头：需要携带token
DELETE {{baseUrl}}/api/{{apiVersion}}/patients/1
Authorization: Bearer {{token}}

### 5. 药品管理接口

#### 5.1 获取所有药品列表
# 获取所有药品信息列表
# 请求方式：GET
# 请求路径：/api/v1/medicines
# 请求头：需要携带token
GET {{baseUrl}}/api/{{apiVersion}}/medicines
Authorization: Bearer {{token}}

#### 5.2 获取单个药品信息
# 获取指定ID的药品信息
# 请求方式：GET
# 请求路径：/api/v1/medicines/:id
# 请求头：需要携带token
GET {{baseUrl}}/api/{{apiVersion}}/medicines/1
Authorization: Bearer {{token}}

#### 5.3 创建新药品
# 创建新的药品信息
# 请求方式：POST
# 请求路径：/api/v1/medicines
# 请求头：需要携带token和Content-Type
POST {{baseUrl}}/api/{{apiVersion}}/medicines
Content-Type: application/json
Authorization: Bearer {{token}}

{
    "name": "阿莫西林",
    "description": "抗生素",
    "unit": "片",
    "price": 10.5,
    "quantity": 100,
    "total_price": 1050,
    "status": "active",
    "medicine_code": "1234567890",
    "medicine_type": "抗生素",
    "medicine_category": "处方药",
    "medicine_form": "片剂",
    "medicine_usage": "口服",
    "medicine_side_effects": "胃肠道反应",
    "medicine_storage_conditions": "常温保存",
    "medicine_expiration_date": "2024-03-06",
    "medicine_manufacturer": "辉瑞制药",
    "medicine_batch_number": "1234567890",
    "medicine_production_date": "2024-03-06",
    "medicine_expiry_date": "2024-03-06",
    "medicine_usage_instructions": "口服",
    "medicine_storage_instructions": "常温保存"
}

#### 5.4 更新药品信息
# 更新指定ID的药品信息
# 请求方式：PUT
# 请求路径：/api/v1/medicines/:id
# 请求头：需要携带token和Content-Type
PUT {{baseUrl}}/api/{{apiVersion}}/medicines/1
Content-Type: application/json
Authorization: Bearer {{token}}

{
    "name": "阿莫西林",
    "description": "广谱抗生素",
    "unit": "片",
    "price": 12.5
}

#### 5.5 删除药品
# 删除指定ID的药品
# 请求方式：DELETE
# 请求路径：/api/v1/medicines/:id
# 请求头：需要携带token
DELETE {{baseUrl}}/api/{{apiVersion}}/medicines/1
Authorization: Bearer {{token}}

### 6. 病历管理接口

#### 6.1 获取所有病历列表
# 获取所有病历信息列表
# 请求方式：GET
# 请求路径：/api/v1/medical-records
# 请求头：需要携带token
GET {{baseUrl}}/api/{{apiVersion}}/medical-records
Authorization: Bearer {{token}}

#### 6.2 获取单个病历信息
# 获取指定ID的病历信息
# 请求方式：GET
# 请求路径：/api/v1/medical-records/:id
# 请求头：需要携带token
GET {{baseUrl}}/api/{{apiVersion}}/medical-records/1
Authorization: Bearer {{token}}

#### 6.3 创建新病历
# 创建新的病历信息
# 请求方式：POST
# 请求路径：/api/v1/medical-records
# 请求头：需要携带token和Content-Type
POST {{baseUrl}}/api/{{apiVersion}}/medical-records
Content-Type: application/json
Authorization: Bearer {{token}}

{
    "patient_id": 1,
    "doctor_id": 1,
    "diagnosis": "感冒",
    "treatment": "休息",
    "visit_date": "2024-03-06"
}

#### 6.4 更新病历信息
# 更新指定ID的病历信息
# 请求方式：PUT
# 请求路径：/api/v1/medical-records/:id
# 请求头：需要携带token和Content-Type
PUT {{baseUrl}}/api/{{apiVersion}}/medical-records/1
Content-Type: application/json
Authorization: Bearer {{token}}

{
    "patient_id": 1,
    "doctor_id": 1,
    "diagnosis": "重感冒",
    "treatment": "吃药",
    "visit_date": "2024-03-06"
}

#### 6.5 删除病历
# 删除指定ID的病历
# 请求方式：DELETE
# 请求路径：/api/v1/medical-records/:id
# 请求头：需要携带token
DELETE {{baseUrl}}/api/{{apiVersion}}/medical-records/1
Authorization: Bearer {{token}}

### 使用说明

1. 获取token：
   - 使用登录接口（1.1 用户登录）获取token
   - 登录成功后，响应中会包含token
   - 将获取到的token替换到上面的@token变量中

2. 测试其他接口：
   - 替换token后，即可测试其他需要认证的接口
   - 所有需要认证的接口都会自动使用@token变量

3. 注意事项：
   - 所有需要认证的接口都需要在请求头中携带`Authorization: Bearer {{token}}`
   - 创建和更新接口需要设置`Content-Type: application/json`
   - 日期格式统一使用`YYYY-MM-DD`格式
   - 所有ID参数都需要替换为实际存在的ID

4. 错误处理：
   - 如果遇到401错误，说明token无效或已过期，需要重新登录
   - 如果遇到404错误，说明请求的资源不存在
   - 如果遇到400错误，说明请求参数格式不正确
   - 如果遇到500错误，说明服务器内部错误

/api/v1/sick_templates

### 获取所有病种模板列表
GET {{baseUrl}}/api/{{apiVersion}}/sick_templates
Authorization: Bearer {{token}}

### 获取单个病种模板
GET {{baseUrl}}/api/{{apiVersion}}/sick_templates/104
Authorization: Bearer {{token}}

### 创建病种模板
POST {{baseUrl}}/api/{{apiVersion}}/sick_templates
Authorization: Bearer {{token}}

{
    "name": "感冒",
    "description": "感冒是一种常见的呼吸道疾病",
    "symptoms": "发热、咳嗽、流鼻涕",
    "treatment": "休息、多喝水",
    "icd10_code": "A00.001",
    "common_symptoms": "发热、咳嗽、流鼻涕",
    "diagnosis_description": "感冒是一种常见的呼吸道疾病",
    "treatment_plan": "休息、多喝水",
    "notes": "感冒是一种常见的呼吸道疾病",
    "disease_name": "感冒"
}


### 获取所有医嘱列表
GET {{baseUrl}}/api/{{apiVersion}}/medical_orders
Authorization: Bearer {{token}}

### 获取单个医嘱
GET {{baseUrl}}/api/{{apiVersion}}/medical_orders/1
Authorization: Bearer {{token}}

### 创建医嘱
POST {{baseUrl}}/api/{{apiVersion}}/medical_orders
Authorization: Bearer {{token}}

{
    "patient_id": 1,
    "doctor_id": 1,
    "diagnosis": "感冒",
    "treatment": "休息",
    "visit_date": "2024-03-06",
    "medicine_id": 1,
    "quantity": 1,
    "unit": "片",
    "price": 10.5,
    "total_price": 10.5,
    "status": "pending",
    "follow_up_instructions": "注意休息，多喝水",
    "imaging_tests": "X光检查",
    "treatments": "药物治疗",
    "special_instructions": "注意休息，多喝水",
    "order_status": "pending"
}

### 通过病人id查询病人医嘱
GET {{baseUrl}}/api/{{apiVersion}}/medical_orders/patient/1
Authorization: Bearer {{token}}

### 通过医生id查询医生医嘱
GET {{baseUrl}}/api/{{apiVersion}}/medical_orders/doctor/1
Authorization: Bearer {{token}}

api/v1/doctor_patient_mapping
### 获取所有医生病人映射表
GET {{baseUrl}}/api/{{apiVersion}}/doctor_patient_mapping
Authorization: Bearer {{token}}

### 获取单个医生病人映射表
GET {{baseUrl}}/api/{{apiVersion}}/doctor_patient_mapping/1
Authorization: Bearer {{token}}

### 创建医生病人映射表
# {
#   "error": "parsing time \"2024-03-06 10:00:00 \" as \"2006-01-02T15:04:05Z07:00\": cannot parse \" 10:00:00 \" as \"T\""
# }
POST {{baseUrl}}/api/{{apiVersion}}/doctor_patient_mapping
Authorization: Bearer {{token}}

{
    "patient_id": 1,
    "doctor_id": 1,
    "visit_date": "2024-03-06",
    "diagnosis": "感冒",
    "status": "pending",
    "mapping_id": 1
}


### 更新医生病人映射表
PUT {{baseUrl}}/api/{{apiVersion}}/doctor_patient_mapping/1
Authorization: Bearer {{token}}

{
    "patient_id": 1,
    "doctor_id": 1,
    "visit_date": "2024-03-06 10:00:00",
    "diagnosis": "感冒",
    "status": "pending",
    "mapping_id": 1
}

### 删除医生病人映射表
DELETE {{baseUrl}}/api/{{apiVersion}}/doctor_patient_mapping/1
Authorization: Bearer {{token}}