智慧长护云提供标准RESTful API接口，支持与第三方系统（如HIS系统、医保信息平台等）无缝对接。
OAuth 2.0 Bearer Token
请求/响应均为 JSON
标准 HTTP 方法语义
URL 路径版本控制 v1
所有API请求需在Header中携带访问令牌：
令牌通过 POST /api/v1/auth/token 接口获取，有效期为24小时。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/orders | 获取工单列表，支持分页、状态筛选、日期范围过滤 |
| GET | /api/v1/orders/:id | 获取工单详情，包含服务记录、签到信息等 |
| POST | /api/v1/orders | 创建护理工单，指定客户、服务类型、护理员、预约时间 |
| PUT | /api/v1/orders/:id | 更新工单信息（状态变更、时间调整、护理员更换） |
| POST | /api/v1/orders/:id/checkin | 护理签到（含GPS定位、人脸识别数据） |
| POST | /api/v1/orders/:id/checkout | 护理签退，提交服务记录和护理内容 |
| DELETE | /api/v1/orders/:id | 取消工单（仅限未开始的工单） |
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/customers | 获取客户列表，支持姓名、身份证号、失能等级筛选 |
| GET | /api/v1/customers/:id | 获取客户详情，含基本信息、服务历史、评估记录 |
| POST | /api/v1/customers | 新增客户档案 |
| PUT | /api/v1/customers/:id | 更新客户信息 |
| GET | /api/v1/customers/:id/services | 获取客户服务历史记录 |
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/schedules | 获取排班列表，支持按日期范围、护理员、区域筛选 |
| POST | /api/v1/schedules/generate | AI智能排班，自动生成最优排班方案 |
| PUT | /api/v1/schedules/:id | 手动调整排班 |
| GET | /api/v1/schedules/staff/:id | 获取指定护理员的排班信息 |
| POST | /api/v1/schedules/swap | 排班换班申请 |
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/billing/summary | 获取费用汇总统计（日/周/月） |
| POST | /api/v1/billing/settle | 发起费用结算，生成结算单 |
| GET | /api/v1/billing/:id | 获取结算单详情 |
| POST | /api/v1/billing/:id/upload | 结算数据上传医保平台 |
| GET | /api/v1/billing/reconcile | 获取对账单及差异明细 |
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/assessments | 获取评估任务列表 |
| POST | /api/v1/assessments | 创建评估任务，指定评估员和评估对象 |
| POST | /api/v1/assessments/:id/submit | 提交评估结果（量表数据、AI建议） |
| GET | /api/v1/assessments/:id/report | 获取评估报告PDF |
| PUT | /api/v1/assessments/:id/review | 审核评估报告（通过/驳回） |