从登录到业务闭环。
账号与租户、患者与病历、处方报价、收款与退费。
这里记录已实现的接口,以及每一步的权限和数据边界。
- 登录并授权
调用
POST /api/v1/auth/login,把返回的accessToken填进下方 Authorize。只填令牌,自动添加 Bearer 前缀。 - 选择诊所
用
GET /api/v1/clinics/me获取租户,把其id填入各业务接口的X-Clinic-Id。空列表表示尚未被平台加入诊所。 - 按流程操作
建档 → 创建初诊/复诊 → 保存草稿 → 检查与报价 → 正式提交 → 登记收款。每个新写操作换一个幂等键,重试则复用原键。
先读版本,再写入
GET 响应的 ETag 原样填入 If-Match,保留双引号。患者、药品、病历、价格和财务的版本各自独立。
412 表示版本过期,重新读取后由使用者确认;428 表示缺少版本条件。
金额由服务端决定
金额使用十进制字符串。单味单剂先舍入到分,求和后乘剂数,再加诊金;报价有效期 5 分钟。
临床 ETag:"record-ID-v3"
财务 ETag:"finance-ID-v1"
Idempotency-Key:每个新操作生成新 UUID。同一操作超时重试使用原键和原请求;不要用新键重复付款登记。申请与批准仅占用可退额度,不代表资金已退回。实际退款完成后等额减免应收,保留原账单;不会重新产生这部分欠费。
已开放
账号认证与改密、医生资料、临床字典、方剂模板、药物用法、患者档案与照片、就诊病历、计价配伍、收款欠费退费,以及业务报表。库存相关能力以接口参考中的实际路由为准。
尚未接入
账单 PDF、利润报表、PDF/XLSX 导出、真实扫码支付、自动退款、医保和离线同步。
先维护目录,再开处方
管理员维护五类临床字典、药物用法及方剂模板。模板仅供录入参考,选用后仍须保存病历、检查配伍、报价及提交。字典为空表示尚未维护,不代表接口未配置。
医生资料使用独立 ETag;改密成功会退出所有设备,须以新密码重新登录。
图片与库存按实际业务操作
患者照片有 4 个槽位,上传与读取均鉴权。前端需携带令牌获取图片,不能直接公开静态链接。
处方提交不预占库存,实际发药才扣减。仅退款不会回库;退药验收登记后才回库。具体路径与请求字段见下方接口参考。