API PLEX Developer Guide
ServiceBlog
한국어
한국어
  • API PLEX 개발자 가이드
  • Release Note
    • Release Note
  • Service
    • Biz Message
      • SMS
      • LMS
      • MMS
      • MMS 이미지 업로드
      • 메시지 발송 결과(WebHook)
    • RCS
      • SMS
      • LMS
      • MMS
      • 캐러셀
      • 템플릿
      • 이미지 업로드 API
      • 메시지 발송 결과 (WebHook)
      • 참조코드 및 값 분류
        • RCS 결과 코드
        • 메시지 발송 응답 코드
        • GATEWAY 오류코드
        • message base ID
    • Kakao Message
      • 알림톡
      • 친구톡
      • 이미지 업로드 API
      • Failback
      • 메시지 발송 결과 (WebHook)
    • Naver Message
      • 네이버 톡톡
      • 네이버 톡톡 (광고성)
    • Global Message
      • GMS
        • GMS (v2)
        • GMS (v1)
        • 메세지 발송 결과(WebHook)
        • 참조 코드
          • 메시지 상태 코드
          • 서비스 오류 코드
      • WhatsApp
      • Viber
    • Email
      • 이메일 스탠다드
      • 이메일 유효검사
    • Push
      • 앱푸시
        • 앱푸시 일괄발송
        • 앱푸시 단건발송
      • 웹푸시
        • 웹푸시 구독 신청
        • 웹푸시 일괄 발송
    • Additional Service
      • 080 수신거부
      • Fax
  • MarketPlace
    • Public API Market
      • 버스 노선 정보 조회 서비스
        • 노선 기본 정보 항목 조회
        • 노선 경로 목록 조회
        • 노선 번호 목록 조회
        • 노선 별 경유 정류소 목록 조회
      • 버스 위치 정보 조회 서비스
        • 특정 정류소 버스 위치 정보 조회
        • 노선 버스 위치 정보 목록 조회
        • 특정 차량 위치 정보 조회
        • 교통 약자 전용-특정 정류소 버스 위치 정보 목록 조회
        • 교통 약자 전용-노선 버스 위치 정보 목록 조회
      • 부동산 거래 신고된 아파트의 전월세 정보 조회
      • 지하철 특정 호선 역 간 거리 및 소요 시간 조회
      • 지하철 특정 호선 지하철역 정보 조회
      • 병원 정보 조회
      • 약국 정보 조회 서비스
        • 약국 목록 정보 조회
        • 약국 위치 정보 조회
        • 약국 별 기본정보 조회
        • 약국 FullData 내려받기
      • 미세먼지 경보 발령 현황 조회
    • AI Market
      • OpenAI
        • chatGPT 3.5 Turbo
Powered by GitBook
On this page
  • 미세 먼지 경보 발령 현황 조회 API
  • Request Body
  • 요청 및 응답 예시
  • (초)미세먼지 경보 권역
  • 에러 코드정리

Was this helpful?

  1. MarketPlace
  2. Public API Market

미세먼지 경보 발령 현황 조회

캐릭터 인코딩은 UTF-8 을 기본으로 합니다.

secret key는 ‘서비스콘솔’ – ‘Sub Account’ 생성 시 키를 발급 받을 수 있습니다.

상세기능 번호

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

Name
Type
Description

numOfRows

number

한 페이지 결과 수(최대 4자리)

itemCode

string

미세먼지 항목 구분

(PM10, PM25)

PM10, PM25 모두

조회할 경우 파라미터 생략

year*

number

측정 연도(4자리 숫자)

pageNo

number

페이지 번호(최대 4자리)

Headers

Name
Type
Description

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

{
  "response": {
      "header": {
           "resultCode": "00",
           "resultMsg": "NORMAL_CODE"
      },
      "body": {
           "pageNo": 1,
           "totalCount": 304,
           "items": {
              "item": [
                  {
                      "dataDate": "2020-12-29",
                      "clearDate": "2020-12-29",
                      "districtName": "세종",
                      "issueTime": "12:00",
                      "clearTime": "19:00",
                      "itemCode": "PM25",
                      "sn": 322,
                      "issueDate": "2020-12-29",
                      "issueVal": 80,
                      "clearVal": 33,
                      "moveName": "세종권역",
                      "issueGbn": "주의보"
                  },
                  {
                      "dataDate": "2020-12-29",
                      "clearDate": "2020-12-29",
                      "districtName": "충북",
                      "issueTime": "13:00",
                      "clearTime": "19:00",
                      "itemCode": "PM25",
                      "sn": 323,
                      "issueDate": "2020-12-29",
                      "issueVal": 77,
                      "clearVal": 33,
                      "moveName": "중부권역",
                      "issueGbn": "주의보"
                  }
              ]
          },
           "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?