全国三级甲等医院基础信息

按医院名称、别名和省市区查询三甲医院公开信息。
详情页：https://www.gugudata.com/api/details/hospital-3a

当前接口契约

接口详情：https://www.gugudata.com/api/details/hospital-3a

功能说明

覆盖全国三甲医院主体名录；

支持医院名称与常用别名检索；

支持省、市、区县组合筛选；

返回医院名称与常用别名；

返回省市区与详细地址；

返回医院联系电话；

提供稳定分页与匹配总数；

适合医疗服务目录与医院检索；

适合地址补全与机构网点管理；

适合区域医疗资源分析与地图产品；

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	APPKEY，可通过 Query、Header 或 Bearer 传递。 AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。
keyword	string	否	无	医院名称或别名关键词，最多 100 个字符。
province	string	否	无	省份名称或简称，最多 32 个字符。
city	string	否	无	城市名称或简称，最多 32 个字符。
district	string	否	无	区县名称或简称，最多 32 个字符。
pageIndex	integer	否	1	页码，从 1 开始。
pageSize	integer	否	20	每页数量，范围为 1 至 100。

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。
DataStatus.StatusCode	integer	接口业务状态码。
DataStatus.Status	string	接口返回状态。
DataStatus.StatusDescription	string	接口返回状态说明。
DataStatus.ResponseDateTime	string	接口响应时间。
DataStatus.DataTotalCount	integer	筛选后的全部匹配数量。
Data.TotalCount	integer	筛选后的全部匹配数量。
Data.PageIndex	integer	当前页码。
Data.PageSize	integer	每页数量。
Data.Items.Name	string	医院名称；Items 为医院对象数组。
Data.Items.Alias	string	医院别名。
Data.Items.Province	string	所在省份。
Data.Items.City	string	所在城市。
Data.Items.District	string	所在区县。
Data.Items.Address	string	医院地址。
Data.Items.Telephone	string	联系电话。

业务状态说明

业务状态码	业务状态码解释	备注
100	请求成功
501	参数错误	请检查筛选条件和分页参数。
502	请求频率受限	请稍后重试。
503	订单已过期	请检查接口服务有效期。
504	APPKEY 错误	请检查 APPKEY 是否有效。
505	调用额度已用完	请检查剩余调用额度。
900	服务内部错误	请稍后重试。
901	医院数据服务暂时不可用	请稍后重试。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。

Bodyapplication/json

示例

{
    "DataStatus": {
        "ResponseDateTime": "string",
        "DataTotalCount": 0,
        "RequestParameter": "string",
        "StatusDescription": "string",
        "StatusCode": 0
    },
    "Data": {
        "TotalCount": 0,
        "Items": [
            {
                "Address": "string",
                "City": "string",
                "Alias": "string",
                "Province": "string",
                "District": "string",
                "Telephone": "string",
                "Name": "string"
            }
        ],
        "PageIndex": 1,
        "PageSize": 1
    }
}

🟠400参数错误，业务码 501。

🟠401缺少或无效 APPKEY，业务码 504。

🟠403订单过期或额度不可用，业务码 503 或 505。

🟠404资源不存在。请求路径不存在。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

🟠429请求频率受限，业务码 502。

🔴500服务内部错误，业务码 900。

🔴503医院数据服务暂时不可用，业务码 901。

当前接口契约#

功能说明#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

功能说明

请求参数

正常响应字段

业务状态说明