페이지관리자
구성모
02-590-9943

페이지 내용에 대한 문의사항은 각 페이지 담당자에게 문의하여 주시기 바랍니다.


오픈 api에 대한 개선의견
API 레퍼런스

본 자료는 T/M 관측소에서 송신된 원시자료 입니다. 이 자료는 측정기기의 오작동, 전파경로상의 혼선, 측정지점의 변화, 계절의 영향 등에 대한 보정을 거친 최종자료와 다를 수 있습니다. 따라서 사용자는 개인(대중)의 안전과 관련된 의사결정 또는 영리를 목적으로 하는 사업에 본 자료를 사용하기에 앞서 주의를 기울여야 하며, 이를 소홀히 함으로써 발생된 제반책임은 사용자에게 있음을 알려드리니, 이상이 있을 경우 담당자에게 문의바랍니다.
한국수자원공사(02-2150-0317), 한국수력원자력(033-245-2330)에서 제공하는 자료에 대한 자세한 사항은 해당기관에 문의하시기 바랍니다.


1-1.수위 자료 요청 포맷
변수명 필수여부 사용예 설명
ServiceKey 필수 OpenAPI 인증키 한강홍수통제소에서 발급한 OpenAPI 인증키
HydroType 필수 waterlevel 수문자료 종류 : 수위
DataType 필수 list 실시간 자료
TimeType 필수 10M 10분 단위 자료
1H 1시간 단위 자료
1D 1일 단위 자료
Wlobscd 선택 관측소 코드 수위 관측소 코드, 명시하지 않을 경우 전체 관측소의 최종 시간 자료 제공
Sdt 선택 yyyyMMddHHmm 검색 시작시간 및 검색 종료시간(10분 단위), 최대1개월
yyyyMMddHH 검색 시작시간 및 검색 종료시간(1시간 단위), 최대1년
Edt yyyyMMdd 검색 시작시간 및 검색 종료시간(1일 단위), 최대1년
DocumentType 필수 .xml xml 문서 포맷
.json json 문서 포맷

※ 굵은 글씨는 고정값을 의미합니다.
※ 관측소코드 및 검색기간을 명시하지 않을 경우 최종 시간의 자료만 제공 됩니다.
※ 낙동강, 금강, 영산강 권역의 자료는 한강 권역의 자료 보다 늦게 수집 됩니다.
   한강 권역 : 7~8분, 낙동강, 금강, 영산강 권역 : 11분 이상
   따라서 관측소별로 최종자료 시간이 다를 수 있습니다.
※ 검색시간 조회시 관측소 코드는 필수 입력입니다.

1-2.요청 URL 예시

• 전체 10분 자료 : http://api.hrfco.go.kr/ServiceKey/waterlevel/list/10M.xml

• 서울시(한강대교) 10분 자료 : http://api.hrfco.go.kr/ServiceKey/waterlevel/list/10M/1018683.xml

• 서울시(한강대교) 10분 기간별 자료 : http://api.hrfco.go.kr/ServiceKey/waterlevel/list/10M/1018683/201709260100/201709270100.xml




1-3.요청결과 출력
No 출력명 출력설명
1 WLOBSCD 수위 관측소 코드
2 YMDHM 년월일시분(yyyyMMddHHmm)
3 WL 수위자료(단위 : m)
4 FW 유량자료(단위 : m³/s)

2-1.수위 관측소 제원 요청 포맷
변수명 필수여부 사용예 설명
ServiceKey 필수 OpenAPI 인증키 한강홍수통제소에서 발급한 OpenAPI 인증키
HydroType 필수 waterlevel 수문자료 종류 : 수위
DataType 필수 info 관측소 제원 정보
DocumentType 필수 .xml xml 문서 포맷
.json json 문서 포맷

※ 굵은 글씨는 고정값을 의미합니다.

2-2. 제원 요청 URL 예시

• 관측소 제원 : http://api.hrfco.go.kr/ServiceKey/waterlevel/info.xml




2-3. 제원 요청결과 출력
No 출력명 출력설명
1 WLOBSCD 수위 관측소 코드
2 OBSNM 수위 관측소 명칭
3 AGCNM 관할 기관
4 ADDR 주소
5 ETCADDR 나머지 주소
6 LON 경도(000-00-00, 세계측지계)
7 LAT 위도(000-00-00, 세계측지계)
8 GDT 영점표고(단위:EL.m)
9 WRNWL 주의보 수위(단위:m)
10 ALMWL 경보 수위(단위:m)
11 PFH 계획홍수위(단위:m)
3-1. 오픈 API 테스트

본 자료는 T/M 관측소에서 송신된 원시자료 입니다. 이 자료는 측정기기의 오작동, 전파경로상의 혼선, 측정지점의 변화, 계절의 영향 등에 대한 보정을 거친 최종자료와 다를 수 있습니다. 따라서 사용자는 개인(대중)의 안전과 관련된 의사결정 또는 영리를 목적으로 하는 사업에 본 자료를 사용하기에 앞서 주의를 기울여야 하며, 이를 소홀히 함으로써 발생된 제반책임은 사용자에게 있음을 알려드리니, 이상이 있을 경우 담당자에게 문의바랍니다.
한국수자원공사(02-2150-0317), 한국수력원자력(033-245-2330)에서 제공하는 자료에 대한 자세한 사항은 해당기관에 문의하시기 바랍니다.


1-1.강수량 자료 요청 포맷
변수명 필수여부 사용예 설명
ServiceKey 필수 OpenAPI 인증키 한강홍수통제소에서 발급한 OpenAPI 인증키
HydroType 필수 rainfall 수문자료 종류 : 강수량
DataType 필수 list 실시간 자료
TimeType 필수 10M 10분 단위 자료
1H 1시간 단위 자료
1D 1일 단위 자료
Rfobscd 선택 관측소 코드 강수량 관측소 코드, 명시하지 않을 경우 전체 관측소의 최종 시간 자료 제공
Sdt 선택 yyyyMMddHHmm 검색 시작시간 및 검색 종료시간(10분 단위), 최대1개월
yyyyMMddHH 검색 시작시간 및 검색 종료시간(1시간 단위), 최대1년
Edt yyyyMMdd 검색 시작시간 및 검색 종료시간(1일 단위), 최대1년
DocumentType 필수 .xml xml 문서 포맷
.json json 문서 포맷

※ 굵은 글씨는 고정값을 의미합니다.
※ 관측소코드 및 검색기간을 명시하지 않을 경우 최종 시간의 자료만 제공 됩니다.
※ 낙동강, 금강, 영산강 권역의 자료는 한강 권역의 자료 보다 늦게 수집 됩니다.
   한강 권역 : 7~8분, 낙동강, 금강, 영산강 권역 : 11분 이상
   따라서 관측소별로 최종자료 시간이 다를 수 있습니다.
※ 검색시간 조회시 관측소 코드는 필수 입력입니다.

1-2.요청 URL 예시

• 전체 10분 자료 : http://api.hrfco.go.kr/ServiceKey/rainfall/list/10M.xml

• 서울시(대곡교) 10분 자료 : http://api.hrfco.go.kr/ServiceKey/rainfall/list/10M/10184100.xml

• 서울시(대곡교) 10분 기간별 자료 : http://api.hrfco.go.kr/ServiceKey/rainfall/list/10M/10184100/201709260100/201709270100.xml




1-3.요청결과 출력
No 출력명 출력설명
1 RFOBSCD 강수량 관측소 코드
2 YMDHM 년월일시분(yyyyMMddHHmm)
3 RF 강수량자료(단위 : mm)

2-1. 강수량 관측소 제원 요청 포맷
변수명 필수여부 사용예 설명
ServiceKey 필수 OpenAPI 인증키 한강홍수통제소에서 발급한 OpenAPI 인증키
HydroType 필수 rainfall 수문자료 종류 : 강수량
DataType 필수 info 관측소 제원 정보
DocumentType 필수 .xml xml 문서 포맷
.json json 문서 포맷

※ 굵은 글씨는 고정값을 의미합니다.

2-2. 제원 요청 URL 예시

• 관측소 제원 : http://api.hrfco.go.kr/ServiceKey/rainfall/info.xml




2-3. 제원 요청결과 출력
No 출력명 출력설명
1 RFOBSCD 강수량 관측소 코드
2 OBSNM 강수량 관측소 명칭
3 AGCNM 관할 기관
4 ADDR 주소
5 ETCADDR 나머지 주소
6 LON 경도(000-00-00, 세계측지계)
7 LAT 위도(000-00-00, 세계측지계)
3-1. 오픈 API 테스트

본 자료는 T/M 관측소에서 송신된 원시자료 입니다. 이 자료는 측정기기의 오작동, 전파경로상의 혼선, 측정지점의 변화, 계절의 영향 등에 대한 보정을 거친 최종자료와 다를 수 있습니다. 따라서 사용자는 개인(대중)의 안전과 관련된 의사결정 또는 영리를 목적으로 하는 사업에 본 자료를 사용하기에 앞서 주의를 기울여야 하며, 이를 소홀히 함으로써 발생된 제반책임은 사용자에게 있음을 알려드리니, 이상이 있을 경우 담당자에게 문의바랍니다.
본 자료는 한국수자원공사(02-2150-0316), 한국수력원자력(033-245-2330)에서 제공하는 자료로써 자세한 사항은 해당기관에 문의하시기 바랍니다.


1-1.댐 자료 요청 포맷
변수명 필수여부 사용예 설명
ServiceKey 필수 OpenAPI 인증키 한강홍수통제소에서 발급한 OpenAPI 인증키
HydroType 필수 dam 수문자료 종류 : 댐
DataType 필수 list 실시간 자료
TimeType 필수 10M 10분 단위 자료
1H 1시간 단위 자료
1D 1일 단위 자료
Dmobscd 선택 관측소 코드 댐 관측소 코드, 명시하지 않을 경우 전체 관측소의 최종 시간 자료 제공
Sdt 선택 yyyyMMddHHmm 검색 시작시간 및 검색 종료시간(10분 단위), 최대1개월
yyyyMMddHH 검색 시작시간 및 검색 종료시간(1시간 단위), 최대1년
Edt yyyyMMdd 검색 시작시간 및 검색 종료시간(1일 단위), 최대1년
DocumentType 필수 .xml xml 문서 포맷
.json json 문서 포맷

※ 굵은 글씨는 고정값을 의미합니다.
※ 관측소코드 및 검색기간을 명시하지 않을 경우 최종 시간의 자료만 제공 됩니다.
※ 낙동강, 금강, 영산강 권역의 자료는 한강 권역의 자료 보다 늦게 수집 됩니다.
   한강 권역 : 7~8분, 낙동강, 금강, 영산강 권역 : 11분 이상
   따라서 관측소별로 최종자료 시간이 다를 수 있습니다.
※ 검색시간 조회시 관측소 코드는 필수 입력입니다.

1-2.요청 URL 예시

• 전체 10분 자료 : http://api.hrfco.go.kr/ServiceKey/dam/list/10M.xml

• 소양강댐 10분 자료 : http://api.hrfco.go.kr/ServiceKey/dam/list/10M/1012110.xml

• 소양강댐 10분 기간별 자료 : http://api.hrfco.go.kr/ServiceKey/dam/list/10M/1012110/201709260100/201709270100.xml




1-3.요청결과 출력
No 출력명 출력설명
1 DMOBSCD 댐 관측소 코드
2 YMDHM 년월일시분(yyyyMMddHHmm)
3 SWL 현재수위(단위:El.m)
4 INF 유입량(단위:m^3/s)
5 SFW 저수량(단위:만m^3)
6 ECPC 공용량(단위:백만m^3)
7 TOTOTF 총 방류량(단위:m^3/s)

2-1. 댐 관측소 제원 요청 포맷
변수명 필수여부 사용예 설명
ServiceKey 필수 OpenAPI 인증키 한강홍수통제소에서 발급한 OpenAPI 인증키
HydroType 필수 dam 수문자료 종류 : 댐
DataType 필수 info 관측소 제원 정보
DocumentType 필수 .xml xml 문서 포맷
.json json 문서 포맷

※ 굵은 글씨는 고정값을 의미합니다.

2-2. 제원 요청 URL 예시

• 관측소 제원 : http://api.hrfco.go.kr/ServiceKey/dam/info.xml




2-3. 제원 요청결과 출력
No 출력명 출력설명
1 DMOBSCD 댐 관측소 코드
2 OBSNM 댐 관측소 명칭
3 AGCNM 관할 기관
4 ADDR 주소
5 ETCADDR 나머지 주소
6 LON 경도(000-00-00, 세계측지계)
7 LAT 위도(000-00-00, 세계측지계)
8 PFH 계획홍수위(단위:m)
9 FLDLMTWL 제한수위 (El.m)
3-1. 오픈 API 테스트

본 자료는 T/M 관측소에서 송신된 원시자료 입니다. 이 자료는 측정기기의 오작동, 전파경로상의 혼선, 측정지점의 변화, 계절의 영향 등에 대한 보정을 거친 최종자료와 다를 수 있습니다. 따라서 사용자는 개인(대중)의 안전과 관련된 의사결정 또는 영리를 목적으로 하는 사업에 본 자료를 사용하기에 앞서 주의를 기울여야 하며, 이를 소홀히 함으로써 발생된 제반책임은 사용자에게 있음을 알려드리니, 이상이 있을 경우 담당자에게 문의바랍니다.
본 자료는 한국수자원공사(031-880-6221)에서 제공하는 자료로써 자세한 사항은 해당기관에 문의하시기 바랍니다.


1-1.보 자료 요청 포맷
변수명 필수여부 사용예 설명
ServiceKey 필수 OpenAPI 인증키 한강홍수통제소에서 발급한 OpenAPI 인증키
HydroType 필수 bo 수문자료 종류 : 보
DataType 필수 list 실시간 자료
TimeType 필수 10M 10분 단위 자료
1H 1시간 단위 자료
1D 1일 단위 자료
Boobscd 선택 관측소 코드 보 관측소 코드, 명시하지 않을 경우 전체 관측소의 최종 시간 자료 제공
Sdt 선택 yyyyMMddHHmm 검색 시작시간 및 검색 종료시간(10분 단위), 최대1개월
yyyyMMddHH 검색 시작시간 및 검색 종료시간(1시간 단위), 최대1년
Edt yyyyMMdd 검색 시작시간 및 검색 종료시간(1일 단위), 최대1년
DocumentType 필수 .xml xml 문서 포맷
.json json 문서 포맷

※ 굵은 글씨는 고정값을 의미합니다.
※ 관측소코드 및 검색기간을 명시하지 않을 경우 최종 시간의 자료만 제공 됩니다.
※ 낙동강, 금강, 영산강 권역의 자료는 한강 권역의 자료 보다 늦게 수집 됩니다.
   한강 권역 : 7~8분, 낙동강, 금강, 영산강 권역 : 11분 이상
   따라서 관측소별로 최종자료 시간이 다를 수 있습니다.
※ 검색시간 조회시 관측소 코드는 필수 입력입니다.

1-2.요청 URL 예시

• 전체 10분 자료 : http://api.hrfco.go.kr/ServiceKey/bo/list/10M.xml

• 강천보 10분 자료 : http://api.hrfco.go.kr/ServiceKey/bo/list/10M/1007801.xml

• 강천보 10분 기간별 자료 : http://api.hrfco.go.kr/ServiceKey/bo/list/10M/1007801/201709260100/201709270100.xml




1-3.요청결과 출력
No 출력명 출력설명
1 BOOBSCD 보 관측소 코드
2 YMDHM 년월일시분(yyyyMMddHHmm)
3 SWL 보 상류수위(단위:El.m)
4 OWL 보 하류수위(단위:El.m)
5 INF 유입량(단위:m^3/s)
6 SFW 저수량(단위:만m^3)
7 ECPC 공용량(단위:백만m^3)
8 TOTOTF 총 방류량(단위:m^3/s)

2-1. 보 관측소 제원 요청 포맷
변수명 필수여부 사용예 설명
ServiceKey 필수 OpenAPI 인증키 한강홍수통제소에서 발급한 OpenAPI 인증키
HydroType 필수 bo 수문자료 종류 : 보
DataType 필수 info 관측소 제원 정보
DocumentType 필수 .xml xml 문서 포맷
.json json 문서 포맷

※ 굵은 글씨는 고정값을 의미합니다.

2-2. 제원 요청 URL 예시

• 관측소 제원 : http://api.hrfco.go.kr/ServiceKey/bo/info.xml




2-3. 제원 요청결과 출력
변수명 타입 설명
1 BOOBSCD 보 관측소 코드
2 OBSNM 보 관측소 명칭
3 AGCNM 관할 기관
4 ADDR 주소
5 ETCADDR 나머지 주소
6 LON 경도(000-00-00, 세계측지계)
7 LAT 위도(000-00-00, 세계측지계)
8 SPCWL 관리수위 (EL.m)
9 PFH 계획홍수위(단위:m)
3-1. 오픈 API 테스트
1-1.레이더 자료 요청 포맷
변수명 필수여부 사용예 설명
ServiceKey 필수 OpenAPI 인증키 한강홍수통제소에서 발급한 OpenAPI 인증키
HydroType 필수 radar 수문자료 종류 : 레이더
DataType 필수 list 실시간 자료
Site 필수 관측소 코드 레이더 관측소 코드

  합성도 : COMP
  임진강 : IMJ
  소백산 : SBS
  비슬산 : BSL
  모후산 : MHS
  서대산 : SDS
  가리산 : GRS
Edt 선택 yyyyMMddHHmm 종료시간을 기준으로 30분 자료 제공, 명시하지 않을 경우 선택 관측소의 최근 30분 자료 제공
DocumentType 필수 .xml xml 문서 포맷
.json json 문서 포맷

※ 굵은 글씨는 고정값을 의미합니다.

1-2.요청 URL 예시

• 합성도 자료 : http://api.hrfco.go.kr/ServiceKey/radar/list/COMP.xml

• 합성도 기간 자료 : http://api.hrfco.go.kr/ServiceKey/radar/list/COMP/201511010100.xml


1-3.요청결과 출력
No 출력명 출력설명
1 IMG 레이더 파일 이미지 URL
2-1. 오픈 API 테스트
1-1. 홍수예보 발령 자료 요청 포맷
변수명 필수여부 사용예 설명
ServiceKey 필수 OpenAPI 인증키 한강홍수통제소에서 발급한 OpenAPI 인증키
HydroType 필수 fldfct 수문자료 종류 : 홍수예보 발령
DataType 필수 list 최근 24시간 자료 제공
Edt 선택 yyyyMMdd 종료시간을 기준으로 전일 자료 제공, 명시하지 않을 경우 전체 관측소의 최근 24시간 자료 제공
DocumentType 필수 .xml xml 문서 포맷
.json json 문서 포맷

※ 굵은 글씨는 고정값을 의미합니다.
※ Edt 명시하지 않을 경우 전체 관측소의 최근 24시간 자료만 제공합니다.

1-2.요청 URL 예시

• 홍수예보 발령 자료 : http://api.hrfco.go.kr/ServiceKey/fldfct/list.xml




1-3.요청결과 출력
No 출력명 출력설명
1 ANCDT 발표일시
2 ANCNM 발표자
3 FCTDT 수위 도달 예상일시
4 FCTHGT 예상 수위표수위
5 FCTSEALVL 예상 해발수위
6 KIND 홍수예보 종류
7 NO 홍수예보 번호
8 OBSNM 지점
9 PRNTDT 기존 발령일시
10 RFRNC2 비고
11 RVRNM 강명
12 STTCURCNG 변동상황
13 STTCURDT 현재 일시
14 STTCURHGT 현재 수위표수위
15 STTCURSEALVL 현재 해발수위
16 STTFCTDT 예상 일시
17 STTFCTHGT 예상 수위표수위
18 STTFCTSEALVL 예상 해발수위
19 STTNM 관측소 코드
20 WRNARANM 주의 지역
21 WRNRVRNM 주의 강명
2-1. 오픈 API 테스트
요청 타입
설정
HydroType
DataType
TimeType
관측소 코드
검색 시작 시간
검색 종료 시간
DocumentType
API 호출
호출 URL
결과
* 오류 코드 설명
오류 코드 설명
900

인증키가 유효하지 않습니다.
인증키가 없는 경우, 오픈 API -> 인증키 메뉴에서 인증키를 신청하십시오.

910

Time Type 파라미터 입력 형식이 잘못 되었습니다.

920

잘못된 관측소 코드입니다.

930

잘못된 날짜 형식입니다.

940

API 인증에 실패 하였습니다.
사용 URL(DNS, IP)를 확인하세요.

941

미 승인 인증키 입니다.
등록된 이메일 주소로 승인 메일을 발송 하였습니다.

942

차단된 인증키 입니다.
인증키 사용시 관리자에게 연락주세요.

943

휴면 인증키 입니다.
인증키 관리에서 휴면 해제후 사용하세요.

944

삭제된 인증키 입니다.

990

검색된 자료가 없습니다.
요청 내용이 잘못 되었거나 결과 자료가 없습니다.

400

서버가 요청의 구문을 인식하지 못했습니다.

401

이 요청은 인증이 필요합니다.

403

서버에서 요청을 거부하고 있습니다.

404

요청하신 주소를 서버에서 찾을 수 없습니다.

500

서버 오류입니다.
지속적으로 발생시 API 담당자에게 문의 바랍니다.

501

서버 오류입니다.
지속적으로 발생시 API 담당자에게 문의 바랍니다.

502

서버 오류입니다.
지속적으로 발생시 API 담당자에게 문의 바랍니다.

503

서버 오류입니다.
지속적으로 발생시 API 담당자에게 문의 바랍니다.

바로가기
  • 홍수예보발령사항
  • 실시간수문자료
  • 홍수예보연보
  • 수문조사연보
  • 하천수사용허가
위로