诊所管家 API 概览

欢迎使用蝉印诊所管家 API。本文档旨在帮助开发者将我们的医疗管理能力无缝集成到第三方应用（如移动 App、小程序或内部系统）中。

设计标准

我们的 API 遵循以下设计原则：

• RESTful 风格：虽然部分路由按功能分类，但核心交互遵循标准的 HTTP 动词。
• JSON 交互：所有请求体和响应体均使用 UTF-8 编码的 JSON 格式。
• 稳定安全：核心业务逻辑由后端集中验证，确保数据在多租户环境下的绝对隔离。

接口分类

模块	核心功能
认证与安全	登录鉴权、Token 管理、用户信息同步。
基础数据 / 目录	调取地址、科室、职员等基础 ID 映射。
消息与看板	业务统计指标、今日待办提醒聚合。
客户档案管理	建档、画像分析、随访查询。
客户相册管理	治疗对比照、化验单的多图上传与管理。
渠道报单 API	潜在意向客源的录入与派单跟踪。
预约管理	挂号预约、排班看板、到诊流转。
ERP 与素材库	商品、物料管理，及内容营销素材包。

快速集成步骤

1. 认证：通过用户名密码换取 access_token 。
2. 获取基础数据：调用 /api/cache/* 系列接口获取地址库、来源渠道 ID 等，这些 ID 在其他接口（如建档）中必填。
3. 调试：建议先使用 Postman 或 CURL 测试联调。

系统要求

• 确保您的客户端支持解析 application/json 。
• 请求头部必须携带 Accept: application/json 以获得标准的 API 错误响应，而不是 HTML 页面。