获取患者列表

分页获取当前诊所的患者档案信息，支持按姓名、手机号、就诊日期进行模糊搜索。返回数据包含患者基本信息及最近一次就诊摘要。

GET /api/v1/patients?page=1&size=20&keyword=张三

请求参数 (Query)

参数名	类型	必填	说明
page	Integer	否	页码，默认 1
size	Integer	否	每页条数，默认 20，最大 100
keyword	String	否	搜索关键词，支持姓名、手机号、身份证号模糊匹配
start_date	String	否	就诊开始日期，格式：YYYY-MM-DD

请求示例

curl -X GET "https://api.jingfangzy.com/api/v1/patients?page=1&size=20" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

响应参数

参数名	类型	说明
code	Integer	状态码，200 表示成功
msg	String	提示信息
data.total	Integer	总记录数
data.list	Array	患者列表数组
data.list[].id	String	患者唯一 ID
data.list[].name	String	患者姓名
data.list[].phone	String	手机号（脱敏处理）

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "total": 156,
    "list": [
      {
        "id": "pat_8f7a2b3c",
        "name": "张三",
        "phone": "138****1234",
        "gender": "男",
        "age": 45,
        "last_visit": "2026-06-15"
      }
    ]
  }
}