DEV Community

GuGuData
GuGuData

Posted on

全国三甲医院主体信息 API 接口

#api #webdev #programming

全国三甲医院主体信息 API 接口

接口详情官网地址: https://www.gugudata.com/api/details/hospital-3a

全国三甲医院主体信息 API 提供全国三级甲等医院主体公开基础信息，可用于三甲医院名录查询、医院基础资料补全、医疗数据检索和本地生活服务接入。接口支持按医院名称关键字、省、市、区县筛选，并返回医院主体名称、常见别名、所在地区、地址、联系电话等字段，方便开发者在应用、脚本或数据流程中接入全国三甲医院数据。

gugudata_api_cover

1. 产品功能

  • 返回全国三级甲等医院主体名录口径数据；
  • 支持关键字、省、市、区县组合筛选；
  • 人工每周定期维护数据，保证数据的准确性与实时性；
  • 返回医院名称、别名、地区、地址、电话等公开基础信息；
  • 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
  • 全面兼容 Apple ATS；
  • 全国多节点 CDN 部署；
  • 接口极速响应，多台服务器构建 API 接口负载均衡；

2. API 文档

接口地址: https://api.gugudata.com/location/hospital-3a

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/location/hospital-3a?appkey=YOUR_APPKEY&keyword=YOUR_VALUE&province=YOUR_VALUE&city=YOUR_VALUE&district=YOUR_VALUE&pageIndex=1&pageSize=20

数据预览: https://www.gugudata.com/preview/hospital-3a

接口测试: https://api.gugudata.com/location/hospital-3a/demo

3. 请求参数

参数名 参数类型 是否必须 默认值 备注
appkey string 是 YOUR_APPKEY 付费后获取的 APPKEY
keyword string 否 YOUR_VALUE 医院名称关键字，模糊匹配主体医院名称与常见别名，留空则返回筛选条件下的全部主体医院
province string 否 YOUR_VALUE 按省份过滤，支持完整名称或常见简称，例如：北京市、北京
city string 否 YOUR_VALUE 按城市过滤，支持完整名称或常见简称，例如：北京市、北京
district string 否 YOUR_VALUE 按区县过滤，支持完整名称或常见简称，例如：海淀区、海淀
pageIndex integer 否 1 页码，最小值为 1
pageSize integer 否 20 每页数据量，默认 20，最大值为 100

4. 返回参数

参数名 参数类型 备注
DataStatus.StatusCode integer 接口返回状态码
DataStatus.StatusDescription string 接口返回状态说明
DataStatus.ResponseDateTime string 接口数据返回时间
DataStatus.DataTotalCount integer 当前筛选条件下的主体医院总数，可用于分页计算
Data.TotalCount integer 当前筛选条件下的主体医院总数
Data.PageIndex integer 当前页码
Data.PageSize integer 当前每页数量
Data.Items.Name string 医院主体名称
Data.Items.Alias string 医院常见别名或简称，数据源未提供时返回空字符串
Data.Items.Province string 医院所在省份
Data.Items.City string 医院所在城市
Data.Items.District string 医院所在区县
Data.Items.Address string 医院公开地址，数据源未提供时返回空字符串
Data.Items.Telephone string 医院公开联系电话，数据源未提供时返回空字符串

5. 错误码说明

状态码 错误说明 备注
100 正常返回 -
101 参数错误 -
102 请求频率受限 每秒请求不能超过 100 次
103 账号欠费 -
104 APPKEY 错误 请检查传递的 APPKEY 是否为开发者中心获取到的值
110 接口响应错误 -

6. 适用场景

  • 适合用于医疗服务平台、健康类应用或政企信息系统，构建全国三甲医院检索、医院选择和机构信息展示能力。
  • 适合用于本地生活、地图和城市服务系统，按省、市、区县筛选医院基础信息，减少手工整理医院名录的成本。
  • 适合用于数据治理、CRM、内容运营和知识库建设，将医院名称、别名、地址、电话等公开基础字段接入内部数据流程。

7. 相关接口

Top comments (0)