한강홍수통제소 홈페이지를 방문해 주셔서 고맙습니다 : Welcom to HRFCO(Han river flood control office)

본 자료는 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개월
Sdt		yyyyMMddHH	검색 시작시간 및 검색 종료시간(1시간 단위), 최대1년
Edt		yyyyMMdd	검색 시작시간 및 검색 종료시간(1일 단위), 최대1년
DocumentType	필수	.xml	xml 문서 포맷
DocumentType	필수	.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/201709240210/201709250210.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 문서 포맷
DocumentType	필수	.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개월
Sdt		yyyyMMddHH	검색 시작시간 및 검색 종료시간(1시간 단위), 최대1년
Edt		yyyyMMdd	검색 시작시간 및 검색 종료시간(1일 단위), 최대1년
DocumentType	필수	.xml	xml 문서 포맷
DocumentType	필수	.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/201709240210/201709250210.xml

1-3.요청결과 출력

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

2-1. 강수량 관측소 제원 요청 포맷

변수명	필수여부	사용예	설명
ServiceKey	필수	OpenAPI 인증키	한강홍수통제소에서 발급한 OpenAPI 인증키
HydroType	필수	rainfall	수문자료 종류 : 강수량
DataType	필수	info	관측소 제원 정보
DocumentType	필수	.xml	xml 문서 포맷
DocumentType	필수	.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개월
Sdt		yyyyMMddHH	검색 시작시간 및 검색 종료시간(1시간 단위), 최대1년
Edt		yyyyMMdd	검색 시작시간 및 검색 종료시간(1일 단위), 최대1년
DocumentType	필수	.xml	xml 문서 포맷
DocumentType	필수	.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/201709240210/201709250210.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 문서 포맷
DocumentType	필수	.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개월
Sdt		yyyyMMddHH	검색 시작시간 및 검색 종료시간(1시간 단위), 최대1년
Edt		yyyyMMdd	검색 시작시간 및 검색 종료시간(1일 단위), 최대1년
DocumentType	필수	.xml	xml 문서 포맷
DocumentType	필수	.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/201709240210/201709250210.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 문서 포맷
DocumentType	필수	.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 문서 포맷
DocumentType	필수	.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 문서 포맷
DocumentType	필수	.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 테스트

오류 코드	설명
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 담당자에게 문의 바랍니다.

요청 타입 설정	HydroType
	DataType
	TimeType
	관측소 코드
	검색 시작 시간
	검색 종료 시간
	DocumentType
	API 호출
호출 URL
결과