35 lines
905 B
Markdown
35 lines
905 B
Markdown
# api-client
|
|
|
|
医签通公共接口客户端，负责封装前端访问后端 API 的方式。
|
|
|
|
## 计划职责
|
|
|
|
- 统一 API 基础地址；
|
|
- 统一请求和响应类型；
|
|
- 统一认证信息传递；
|
|
- 统一错误处理；
|
|
- 封装患者、就诊、医嘱、文书和签署任务接口；
|
|
- 处理超时、重试和重复提交；
|
|
- 配合 OpenAPI 生成类型安全的接口代码。
|
|
|
|
## 计划接口类别
|
|
|
|
- 患者和就诊查询；
|
|
- 文书模板查询；
|
|
- 签署任务创建；
|
|
- 签署状态查询；
|
|
- 签署结果提交；
|
|
- PDF 原件和签名证据查询；
|
|
- Webhook 或回传状态确认。
|
|
|
|
## 使用原则
|
|
|
|
- 不在这里放页面代码；
|
|
- 不在前端保存服务端密钥；
|
|
- 最终权限和签署有效性由后端校验；
|
|
- 不能为了方便在多个应用中复制同一套接口定义。
|
|
|
|
## 当前状态
|
|
|
|
当前仅完成目录和说明文档，尚未创建接口代码。
|