미세먼지 경보 발령 현황 조회
상세기능 번호
1
상세기능 유형
조회(목록)
상세기능명(국문)
미세먼지 경보 정보 현황 조회
상세기능 설명
미세먼지(PM10, PM2.5)에 대한 지역별 주의보-경보 발령/해제시간, 농도를 조회합니다.
Call Back URL
https://i48ojxo10p.apigw.ntruss.com/public_fine_dust/v1/info
최대 메시지 사이즈
1000 byte
평균 응답 시간
500 ms
초당 최대 트랙잭션
50 tps
미세 먼지 경보 발령 현황 조회 API
GET
https://4vh6qtie3c.apigw.ntruss.com/public_fine_dust/v1/info
Query Parameters
numOfRows
number
한 페이지 결과 수(최대 4자리)
itemCode
string
미세먼지 항목 구분
(PM10, PM25)
PM10, PM25 모두
조회할 경우 파라미터 생략
year*
number
측정 연도(4자리 숫자)
pageNo
number
페이지 번호(최대 4자리)
Headers
Authorization*
string
사용자ID;secret key
Request Body
resultCode
결과코드
2
Y
00
결과코드
resultMsg
결과메세지
50
Y
NORMAL SERVICE.
결과메세지
numOfRows
한 페이지 결과 수
4
Y
100
한 페이지 결과 수
pageNo
페이지 번호
4
Y
1
페이지 번호
totalCount
전체 결과 수
4
Y
251
전체 결과 수
items
목록
-
-
-
목록
sn
관리번호
5
Y
262
미세먼지 경보 관리번호
(2020년 신규추가)
dataDate
발령일
10
Y
2020-10-28
발령 날짜
districtName
지역명
100
Y
경기
발령 지역 이름
moveName
권역명
100
Y
남부권
발령 권역 이름
itemCode
항목명
10
Y
PM25
미세먼지 항목 구분(PM10,PM25)
issueGbn
경보단계
10
Y
주의보
경보단계
(주의보, 경보)
issueDate
발령일
10
Y
2020-10-28
발령 날짜
issueTime
발령시간
5
Y
03:00
발령 시간
issueVal
발령농도
10
Y
76
발령시 미세먼지 농도(단위: ㎍/m3)
clearDate
해제일
10
Y
2020-10-28
해제 날짜
clearTime
해제시간
5
Y
13:00
해제 시간
clearVal
해제농도
10
Y
28
해제시 미세먼지 농도(단위: ㎍/m3)
요청 및 응답 예시
https://i48ojxo10p.apigw.ntruss.com/public_fine_dust/v1/info?year=2020&pageNo=1&numOfRows=2
(초)미세먼지 경보 권역
서울
1
서울권역
서울특별시 전 지역
부산
2
남부권역
동구, 서구, 남구, 중구, 수영구, 영도구, 해운대구
3
동부권역
기장군
4
서부권역
강서구, 북구, 사상구, 사하구
5
중부권역
금정구, 동래구, 연제구, 부산진구
대구
6
대구권역
대구광역시 전 지역
인천
7
강화권역
강화군
8
동남부권역
계양구, 부평구, 미추홀구, 연수구, 남동구
9
서부권역
서구, 중구(영종도 ․ 용유도 제외), 동구
10
영종·영흥권역
중구(영종도·용유도), 옹진군(영흥)
광주
11
광주권역
광주광역시 전 지역
대전
12
동부권역
동구, 대덕구, 중구
13
서부권역
서구, 유성구
울산
14
울산권역
울산광역시 전 지역
세종
15
세종권역
세종시 전 권역
경기
16
남부권
용인시, 평택시, 안성시, 이천시, 여주시
17
동부권
남양주시, 구리시, 하남시, 광주시, 성남시, 가평군, 양평군
18
북부권
김포시, 고양시, 의정부시, 파주시, 연천군, 양주시, 동두천시, 포천시
19
중부권
수원시, 안산시, 안양시, 부천시, 시흥시, 광명시, 군포시, 의왕시, 과천시, 화성시, 오산시
강원
20
영서북부
춘천시, 철원군, 양구군, 홍천군, 화천군, 인제군
21
영서남부
원주시, 횡성군, 평창군, 영월군, 정선군
22
영동북부
고성군, 양양군, 속초시
23
영동남부
강릉시, 동해시, 삼척시, 태백시
충북
24
북부권역
충주시, 제천시, 단양군
25
중부권역
청주시, 증평군, 진천군, 괴산군, 음성군
26
남부권역
보은군, 옥천군, 영동군
충남
27
동남부권역
공주시, 청양군, 부여군, 논산시, 계룡시, 금산군
28
북부권역
천안시, 아산시, 당진시
29
서부권역
서산시, 태안군, 예산군, 홍성군, 보령시, 서천군
전북
30
중부권역
전주시, 익산시, 완주군
31
서부권역
군산시, 정읍시, 김제시, 고창군, 부안군
32
동부권역
남원시, 진안군, 무주군, 장수군, 임실군, 순창군
전남
33
동부권
여수시, 순천시, 광양시, 곡성군, 구례군, 고흥군, 보성군
34
서부권
목포시, 해남군, 영암군, 무안군, 함평군, 영광군, 진도군, 신안군
35
중부권
나주시, 담양군, 화순군, 장흥군, 강진군, 장성군, 완도군
경북
36
동부권역
포항시, 경주시, 경산시, 영천시, 청도군, 청송군, 영덕군, 영양군, 봉화군, 울진군
37
서부권역
구미시, 김천시, 안동시, 영주시, 상주시, 문경시, 예천군, 의성군, 군위군, 성주군, 고령군, 칠곡군
38
울릉권역
울릉군
경남
39
거제권역
거제시
40
거창권역
거창군
41
고성권역
고성군
42
김해권역
김해시
43
남해권역
남해군
44
밀양권역
밀양시
45
사천권역
사천시
46
산청권역
산청군
47
양산권역
양산시
48
의령권역
의령군
49
진주권역
진주시
50
창녕권역
창녕군
51
창원권역
창원시
52
통영권역
통영시
53
하동권역
하동군
54
함안권역
함안군
55
함양권역
함양군
56
합천권역
합천군
제주
57
제주권역
제주 전 지역
에러 코드정리
01
Application Error
서비스 제공 상태가 원활하지 않습니다
02
DB Error
서비스 제공 상태가 원활하지 않습니다
03
No Data
데이터 없음 에러
04
HTTP Error
서비스 제공 상태가 원활하지 않습니다
05
service time out
서비스 제공 상태가 원활하지 않습니다
10
잘못된 요청 파라미터 에러
OpenAPI 요청시 파라미터값 요청이 잘못되었습니다
11
필수 요청 파라미터 없음
요청하신 OpenAPI의 필수 파라미터가 누락되었습니다
12
해당 오픈API 서비스가 없거나 폐기됨
OpenAPI 호출시 URL이 잘못됨
20
서비스 접근 거부
활용 신청하지 않은 OpenAPI 호출
22
서비스 요청 제한 횟수 초과 에러
하루 트래픽 제한을 초과함
30
등록하지 않은 서비스키
잘못된 서비스키를 사용하였거나 서비스키를 URL 인코딩하지 않음
31
서비스키 사용 기간 만료
OpenAPI 사용기간이 만료됨(활용기간 연장신청 후 사용가능)
32
등록하지 않은 도메인명 또는 IP주소
활용신청한 서버의 IP와 실제 OpenAPI 호출한 서버가 다를 경우
34
보고서가 등록 되지 않음
개발보고서가 아직 승인되지 않은 경우
Was this helpful?