XML

건강보험심사평가원_병원진료정보조회서비스

QuickAISummary

관심목록에 추가

오픈 API 정보

데이터 오류·개선 의견이 있으신가요?

기본 정보

OpenAPI 명
건강보험심사평가원_병원진료정보조회서비스
분류체계
보건 - 건강보험
제공기관
건강보험심사평가원
관리부서명
빅데이터실
관리부서 전화번호

상세 및 제공정보

설명
요양기호 기준으로 최근 1년간 의원에서 진료된 상위 5개의 질병명 목록을 조회하는 서비스입니다. - 요양기호는 1:1로 매칭한 암호화된 요양기호로 제공하고 있으며, 별도의 복호화 방법 또는 요양기호는 제공하고 있지 않습니다. · 의원급 암호화된 요양기호 확인방법: 건강보험심사평가원 '병원정보서비스' Open API > 병원기본목록 > 요청메시지 clCd(종별코드) = '31'로 고정 후 응답메시지를 확인하시면 됩니다. - 진료량 상위 5위에 해당하는 국민관심질병명을 오름차순으로 정렬하여 제공하고 있습니다.
API 유형
REST
데이터 포맷
XML
공간범위
-
시간범위
-
키워드
건강보험,의원,질병,의료통계,진료정보
활용신청 수
1208
등록일
2016-12-14
수정일
2025-07-07

이용 조건 및 라이선스 정보

비용부과유무
무료
이용허락범위

공공저작물 : 출처표시 (제 1유형)
심의유형
개발단계 : 자동승인 / 운영단계 : 자동승인
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능

참고문서

OpenAPI활용가이드_건강보험심사평가원(병원진료정보조회서비스)_210330.hwp

표준 메타데이터

※ 데이터 연계 및 검색을 위한 표준 메타데이터입니다.

Schema.org DCAT

활용 정보

API 서비스

요양기관기호(암호화 기호)를 통해 최근 1년간 의원에서 진료된 상위 5개의 질병명을 오름차순으로 조회하는 의원진료상위질병5개목록조회 기능

API 기본 정보

활용승인 절차
개발단계 : 자동승인 / 운영단계 : 자동승인
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
요청주소
https://apis.data.go.kr/B551182/hospDiagInfoService1/getClinicTop5List1
서비스 URL
https://apis.data.go.kr/B551182/hospDiagInfoService1

요청변수(Request Parameter)

해당 오픈API의 요청변수(Request Parameter) 항목에 대한 표로, 국문항목명, 영문 항목명, 항목크기, 항목구분, 샘플데이터, 항목 설명순으로 나열됩니다.
항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
서비스 인증키	ServiceKey	400	필수	공공데이터포털에서 받은 인증키	공공데이터포털에서 받은 인증키
한 페이지 결과 수	numOfRows	4	필수	1	한 페이지 결과 수(단일 조회임으로 고정)
페이지 번호	pageNo	4	필수	1	페이지 번호(단일 조회임으로 고정)
암호화된 요양기호	ykiho	100	필수		암호화된 요양기호 (확인방법:건강보험심사평가원오픈API[병원정보서비스>병원기본목록(getHospBasisList)](요청메시지 clCd(종별코드)='31'로고정 후 응답메시지 암호화된 요양기호(ykiho)) )

출력결과(Response Element)

해당 오픈API의 출력결과(Response Element) 항목에 대한 표로, 국문항목명, 영문 항목명, 항목크기, 항목구분, 샘플데이터, 항목 설명순으로 나열됩니다.
항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
결과코드	resultCode	5	필수	00	결과코드
결과메시지	resultMsg	50	필수	NORMALSERVICE	결과메시지
한 페이지 결과 수	numOfRows	4	필수	1	한 페이지 결과 수(고정)
페이지 번호	pageNo	4	필수	1	페이지 번호(고정)
총건수	totalCount	7	필수	1	조회데이터의 총건수(고정)
기준년월	crtrYm	6	필수	202402	자료 생성 년월(기준년월(현재시점-6개월)로부터 최근 1년 자료 제공) 예)기준년월2024년2월은((기준년월-12개월)~(기준년월))기간에추출한자료
국민관심질병명1	mfrnIntrsIlnsNm1	130	옵션	감기	진료량 상위5위에 해당하는 국민관심질병명을 오름차순으로 정렬 함
국민관심질병명2	mfrnIntrsIlnsNm2	130	옵션	당뇨병	진료량 상위5위에 해당하는 국민관심질병명을 오름차순으로 정렬 함
국민관심질병명3	mfrnIntrsIlnsNm3	130	옵션	불면증	진료량 상위5위에 해당하는 국민관심질병명을 오름차순으로 정렬 함
국민관심질병명4	mfrnIntrsIlnsNm4	130	옵션	비염	진료량 상위5위에 해당하는 국민관심질병명을 오름차순으로 정렬 함
국민관심질병명5	mfrnIntrsIlnsNm5	130	옵션	장염	진료량 상위5위에 해당하는 국민관심질병명을 오름차순으로 정렬 함
표시과목명	shwSbjtNm	130	옵션	일반의	의원의 진료과목명
요양기관명	yadmNm	130	필수	태장고려의원	요양기관명
암호화된 요양기호	ykiho	100	필수		암호화된 요양기호

오픈 API에 대한 에러코드를 에러메시지, 에러코드, 설명 순으로 안내하는 표입니다.
에러메시지	에러코드	설명
APPLICATION_ERROR	01	GW 내부 처리 중 예기치 않은 오류가 발생했습니다. 잠시 후 다시 호출하고, 문제가 반복되면 활용지원센터로 문의해 주세요.
HTTP_ERROR	04	허용되지 않은 HTTP 요청이거나 기관 API 응답 처리에 실패했습니다. 요청 방식과 호출 URL을 확인해 주세요.
SERVICETIMEOUT_ERROR	05	기관 API 또는 GW 연계 서비스와의 연결에 실패했거나 응답 대기시간을 초과했습니다. 잠시 후 다시 호출해 주세요.
INVALID_REQUEST_PARAMETER_ERROR	10	요청 파라미터의 값이나 형식이 올바르지 않습니다. API 명세에서 파라미터 이름, 형식 및 허용값을 확인해 주세요.
NO_OPENAPI_SERVICE_ERROR	12	요청한 오픈API 서비스가 존재하지 않거나 폐기되었습니다. 호출 URL에 오타가 없는지 확인해 주세요.
SERVICE_KEY_IS_NULL	20	요청에 API 인증키가 포함되지 않았습니다. 공공데이터포털에서 발급받은 인증키를 요청 파라미터에 포함해 주세요.
PERMISSION_DENIED	20	GW 접근 권한 검사에서 요청이 거부되었습니다. 해당 API의 활용신청 및 접근 권한을 확인해 주세요.
LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR	22	API 서비스의 일일 호출 허용량을 초과했습니다. 호출량이 초기화된 이후 다시 이용하거나 트래픽 증설을 신청해 주세요.
LIMITED_NUMBER_OF_SERVICE_REQUESTS_PER_SECOND_EXCEEDS_ERROR	23	짧은 시간에 많은 요청이 발생하여 초당 호출 허용량을 초과했습니다. 잠시 후 다시 호출해 주세요.
BLACKLIST_IP_ACCESS_ERROR	29	차단된 IP에서 호출한 요청입니다. 호출 서버의 IP를 확인하고, 차단 해제가 필요한 경우 활용지원센터로 문의해 주세요.

인증 에러

오픈 API에 대한 인증 에러코드를 에러메시지, 에러코드, 설명 순으로 안내하는 표입니다.
에러메시지	에러코드	설명
SERVICE_ACCESS_DENIED_ERROR	20	해당 API 서비스에 대한 이용 권한이 확인되지 않습니다. 활용신청 여부와 승인 또는 일시중지 상태를 확인해 주세요.
SERVICE_KEY_IS_NOT_REGISTERED_ERROR	30	등록되지 않은 API 인증키입니다. 인증키가 정확한지와 해당 서비스의 활용신청이 정상적으로 완료되었는지 확인해 주세요.
DEADLINE_HAS_EXPIRED_ERROR	31	API 인증키의 사용 기한이 만료되었습니다. 공공데이터포털에서 이용 기간을 확인하거나 갱신해 주세요.