Hans APIAPI 문서

여러 도메인의 정보와 기능을 하나의 REST API 로 제공합니다. 무엇을 쓰든 인증과 응답 규칙은 같습니다.

시작하기 (인증·다국어)

병원 검색 API

헬스케어

전국 병원 검색 · 진료시간 · 응급실 · 병상 · 장비 · 평가등급

AI · MCP

자연어 → 검색 조건 · AI 도구에 물리는 MCP 엔드포인트

주소

시도 · 시군구 지역 코드 · 공식 영문 주소 표기

사업자

사업자등록번호 상태조회(계속·휴업·폐업) · 진위확인

다국어

Accept-Language 헤더 하나로 한국어 · 영어 · 일본어 · 중국어

시작하기

모든 요청은 https://api.plzhans.com 으로 보냅니다. 인증(Authorization)과 응답 언어(Accept-Language)는 도메인과 무관하게 같습니다 — 공통 을 먼저 읽으세요. 키는 앱 관리 콘솔에서 발급합니다.

# 강남구의 응급실 운영 병원을 영어로
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Accept-Language: en" \
     "https://api.plzhans.com/healthcare/hospitals?region=11680&emergency=true"

제공 도메인

도메인	내용
헬스케어	전국 병원 검색·상세. 검색 조건 코드는 참조 데이터 에서 받습니다
AI · MCP	자연어 질문을 검색 조건으로. AI 도구에 물리는 MCP 엔드포인트
주소	시도·시군구 지역 코드, 한글 주소의 공식 영문 표기
사업자	국세청 사업자등록번호 상태조회·진위확인
교통정보	지하철역 목록(한/영/일)
계정	OAuth 토큰 발급·갱신과 사용자 계정 API

공통 규칙

인증	서비스 키(Authorization) 또는 클라이언트 ID(X-Client-Id)
로그인 연동	OAuth 2.0 Authorization Code + PKCE
다국어	Accept-Language 하나로 한국어·영어·일본어·중국어