安卓接口文档:科室与医生查询指南

需积分: 0 0 下载量 24 浏览量 更新于2024-08-04 收藏 852KB DOCX 举报
"安卓端接口文档1" 在安卓开发中,接口文档是连接前端与后端的重要桥梁,它详细描述了各个API的使用方法、请求类型、URL路径以及响应数据。以下是对给定的安卓端接口文档的详细解读: 1. 接口通用规则: 所有的接口请求方式都是GET,这意味着所有的数据获取都通过HTTP的GET方法完成,这在简单的数据查询操作中非常常见。 2. 医生信息科室接口: - (1)查询所有一级科室: URL:/android/office/first 请求类型:GET 返回数据包括id(一级科室id)和name(一级科室名称)。 - (2)查询所有二级科室: URL:/android/office/second/{id} 请求类型:GET 其中{id}是一级科室id,返回数据包括id(二级科室id)、name(二级科室名称)以及firstOfficeId(关联的一级科室id)。 3. 医生接口: - (1)查询所有医生(通过二级科室id): URL:/android/doctor/all/{id} 请求类型:GET 这里的{id}是指所属的二级科室id。返回数据包含医生总数(count)和医生列表(rows),医生列表中每个医生的信息包括id、name(医生名字)、gender(性别,1代表男,2代表女)、post(职务)、title(职称)、secondOfficeId(所属二级科室id)以及avatarUrl(医生头像相对地址)。 - (2)查询部分医生信息(通过医生id): URL:/android/doctor/one/{id} 请求类型:GET 这里的{id}是指要查询的医生id。返回数据包含医生详细信息,如id、name、description(医生简述)、gender、post、title、resume(医生简历)、concurrent(医生兼职)、achievement(学术成果)、speciality(专业特长)、secondOfficeId以及workInformations(七天出诊信息)。工作信息中包括id(出诊信息id)、department(科室名称)、registerType(挂号类型)、date(出诊日期)、classes(班次)和remaining(剩余号源)。 在实际应用中,前端开发者需要使用这些接口来获取并展示医生和科室的相关信息,例如医生列表、科室分类以及医生的详细资料。同时,注意在处理接口返回的avatarUrl时,由于node.js在封装时会将"\\"转义成"\\\",前端需要使用replaceAll方法将"\\\\"替换回"\",以便正确构建图片的完整URL。此外,使用Postman这样的工具可以帮助开发者测试和调试这些接口,确保它们能够正确无误地工作。