无需登录接口:管理员生成接入 Token
管理员进入“账号管理 → 编辑 → 接入 Token”,随机生成并复制完整Token。集成方将它直接传入Web SDK的token参数,或放入业务接口Authorization: Bearer请求头。无需调用登录接口;每个医生使用自己的Token,权限跟随该账号,停用或重新生成后旧值失效。此Token不能访问管理后台或修改密码。
const client = await LingZhen.createLingZhen({ baseUrl: location.origin, token: '管理员提供的lz_api_开头接入Token', workletUrl: location.origin + '/web/worklets/pcm-worklet.js' });
// 签署身份从 GET /api/v1/auth/access 返回的 accountId 获取,不要自行填写其他医生工号。先确认你要接入的能力
| 能力 | 适用场景 | 方式 |
|---|---|---|
| 语音病历生成 | 在已有业务页面录音、生成草稿、医生核对后保存 | Web SDK + 本系统业务接口 |
| 病历质控 | 提交文书或完整病案,检查、整改、重检、复核 | 服务端质控 API / Java SDK |
本教程范围为医生 Web 与服务端集成。先使用模拟患者资料完成验证,再接入院内正式流程。
① 获取联调账号② 选择病历类型③ 创建会话或质控任务④ 核对结果⑤ 保存并验收
准备好这四项资料
- 系统访问地址:
。院内部署请使用交付人员提供的地址。 - 医院、科室与医生测试账号,以及该账号允许使用的功能。
- 患者编号、就诊编号和拟使用的病历类型;不要在程序中固定类型编码。
- 贵方保存病历的接口、医生审核页面和出错后的重试入口。
调用关系
贵方医生页面Web SDK / 医生核对
⇄智能语音病历服务会话 · 模板 · 质控 · 归档
⇄模型与知识服务由系统后端统一调用
贵方服务端管理账号凭据、获取业务令牌,并保存业务关联信息。模型密钥放在本系统后端。
医生 Web:先跑通一份模拟病历
- 贵方服务端调用
POST /api/v1/auth/login,传入code(医生工号)与password,取响应中的data.token。 - 携带
Authorization: Bearer <token>调用GET /api/v1/record-templates,选择已启用类型。保留返回的类型编码和接诊字段要求。 - 在 HTTPS 页面引入 SDK 和录音工作文件,然后按下方顺序调用。录音须由用户点击触发并授权麦克风。
- 取得草稿后展示给医生核对,保存修改,再执行签字;将返回结果与贵方就诊记录关联保存。
动态类型及字段以接口返回的模板为准。新建时可传 intakeData 与 testData;已有会话使用创建时的模板快照。生成超时或失败保留转写,向医生说明原因并提供重试。
打开 SDK 联调页服务端与质控
业务令牌绑定医院与账号权限。全部业务请求都需要携带 Authorization 请求头;WebSocket 使用 token 查询参数。
| 步骤 | 接口 | 用途 |
|---|---|---|
| 登录 | POST /api/v1/auth/login | 获取业务令牌 |
| 读取类型 | GET /api/v1/record-templates | 取得当前启用类型与接诊要求 |
| 创建会话 | POST /api/v1/sessions | 提交患者编号、类型与接诊资料 |
| 获取草稿 | GET /api/v1/sessions/{id}/draft | 读取结构化病历与来源引用 |
| 保存修改 | PUT /api/v1/sessions/{id}/draft | 提交当前项目列表及草稿修订号 |
| 签字归档 | POST /api/v1/sessions/{id}/confirm | 医生审核并确认保存 |
| 医生自查 | POST /api/v1/qc/self-checks | 创建个人自查任务 |
质控接入前需要双方确认
- 检查对象是单份文书、完整病案还是病案首页,使用哪份院内评分标准。
- 责任医生和复核人如何映射,谁接收整改消息。
- 原文、检查结果、整改记录和重检结果均保存在本系统,外部回传按双方约定实施。
Java 质控 SDK 的请求结构、回调验证与错误处理见下载包 README。完整病案、首页和个人自查属于不同业务接口,不能用单份文书接口替代。具体医院接口由双方联调确认。
SDK 与资料下载
下载后建议按版本保存在贵方自己的静态目录中。Web SDK 和录音工作文件需一起部署。
下载 Web SDK(UMD)下载 Web SDK(ES Module)下载录音工作文件下载 Java 质控 SDK 源码与说明下载 Web 联调页源码自动接入技能仍在规划中,尚未作为正式下载包交付。当前可用的是 SDK、接口说明和联调页。
按这份清单验证接入
- 错误账号或口令会被拒绝;越权账号无法读取其他医生的病历。
- 类型从接口加载,新类型增加字段后仍能正常创建和生成。
- 录音转写可展示、可保存;断开或生成失败不会静默丢失原文。
- 医生修改后保存的是最新内容;签字前要求医生明确确认。
- 质控能完成“检查 → 整改 → 重检 → 提交复核 → 完成”的闭环。
- 模拟数据有标记,不计入正式统计。
- 失败时展示可理解的原因;重复点击不创建重复业务。
常见问题
401:令牌已过期或账号不可用,重新登录。403:检查账号角色与数据范围。生成失败:保留转写后检查模型状态与返回提示;输入容量按完整请求计算,不按文字字数截断。