상세 컨텐츠

본문 제목

공공데이터API - 보건복지부_코로나19 감염_현황

programing/API

by ZelKun 2020. 7. 14. 00:07

본문

반응형

출처 :  https://www.data.go.kr/data/15043376/openapi.do

 

페이지가 나뉘어 있어서 서비스가 다른가 했는데

"보건복지부_코로나19 ·도발생_현황" URL 살짝다른 자매(?) 서비스..

 

게다가 문서번호가 01 시작하는걸보니...

서비스-상세기능(목록) 으로 제공할걸 4개의 서비스로 분리해놨다

데이터포탈이 개편되면서 이전 URL접근을 못하게 막아버린것도 ㅂㄷㅂㄷ 한데..

목록페이지에서 찾아보는것보다는 편하니..

 

문서 제목을보니 코로나바이러스감염증 으로 시작하는걸보니 원래 서비스명이였나보다

 

편의상 제공되는 문서를 기준으로 작성

마찬가지로 분명 문서, 웹에 [O] JSON 체크가 되있는데, 어떻게 쓰라고는 없다

 

서비스URL http://openapi.data.go.kr/openapi/service/rest/Covid19/getCovid19InfStateJson

 

_type=json 뒤에 붙이면 json으로 반환해준다

기본은 xml


상세기능정보

번호

API(국문)

상세기능명(영문)

상세기능명(국문)

1

보건복지부_코로나19감염현황 조회 서비스

Covid19InfStateJson

코로나19감염현황 조회 서비스

 

요청

항목명(국문)

항목명(영문)

항목크기

항목구분

샘플데이터

항목설명

서비스키

ServiceKey

4

필수

-

공공데이터포털에서 받은 인증키

페이지 번호

pageNo

4

옵션

1

페이지번호

한 페이지 결과 수

numOfRows

4

옵션

10

한 페이지 결과 수

데이터 생성일 시작범위

startCreateDt

30

옵션

20200310

검색할 생성일 범위의 시작

데이터 생성일 종료범위

endCreateDt

30

옵션

20200315

검색할 생성일 범위의 종료

 

4개로 분리된 서비스들이 요청 변수가 동일하니

4 서비스를 전부 테스트해본건 안비밀

어째 서비스가 전부다 numOfRows 요청값을 무시하니

페이징처리를 필요가 없다

 

응답

항목명(국문)

항목명(영문)

항목크기

항목구분

샘플데이터

항목설명

결과코드

resultCode

2

필수

00

결과코드

결과메시지

resultMsg

50

필수

OK

결과메시지

한 페이지 결과 수

numOfRows

4

필수

10

한 페이지 결과 수

페이지 번호

pageNo

4

필수

1

페이지번호

전체 결과 수

totalCount

4

필수

3

전체 결과 수

게시글번호(감염현황 고유값)

SEQ

30

필수

74

게시글번호(감염현황 고유값)

기준일

STATE_DT

30

필수

20200315

기준일

기준시간

STATE_TIME

30

필수

00:00

기준시간

확진자 수

DECIDE_CNT

15

필수

8162

확진자 수

격리해제 수

CLEAR_CNT

15

필수

834

격리해제 수

검사진행 수

EXAM_CNT

15

필수

16272

검사진행 수

사망자 수

DEATH_CNT

15

필수

75

사망자 수

치료중 환자 수

CARE_CNT

15

필수

7253

치료중 환자 수

결과 음성 수

RESUTL_NEG_CNT

15

필수

243778

결과 음성 수

누적 검사 수

ACC_EXAM_CNT

15

필수

268212

누적 검사 수

누적 검사 완료 수

ACC_EXAM_COMP_CNT

15

필수

251940

누적 검사 완료 수

누적 환진률

ACC_DEF_RATE

30

필수

3.2396602365

누적 환진률

등록일시분초

CREATE_DT

30

필수

2020-03-15 10:01:22.000

등록일시분초

수정일시분초

UPDATE_DT

30

필수

null

수정일시분초

역시나 Camel case로 응답이 오니 참고

 


응답결과 일부

감염_현황 API

시도별 확진자 API 합계

<item>

                <accDefRate>0.9720252058</accDefRate>

                <accExamCnt>1402144</accExamCnt>

                <accExamCompCnt>1380314</accExamCompCnt>

                <careCnt>950</careCnt>

                <clearCnt>12178</clearCnt>

                <createDt>2020-07-12 10:21:53.323</createDt>

                <deathCnt>289</deathCnt>

                <decideCnt>13417</decideCnt>

                <examCnt>21830</examCnt>

                <resutlNegCnt>1366897</resutlNegCnt>

                <seq>197</seq>

                <stateDt>20200712</stateDt>

                <stateTime>00:00</stateTime>

                <updateDt>null</updateDt>

            </item>

<item>

                <createDt>2020-07-12 10:30:54.416</createDt>

                <deathCnt>289</deathCnt>

                <defCnt>13417</defCnt>

                <gubun>합계</gubun>

                <gubunCn></gubunCn>

                <gubunEn>Total</gubunEn>

                <incDec>44</incDec>

                <isolClearCnt>12178</isolClearCnt>

                <isolIngCnt>950</isolIngCnt>

                <localOccCnt>21</localOccCnt>

                <overFlowCnt>23</overFlowCnt>

                <qurRate>25.88</qurRate>

                <seq>2915</seq>

                <stdDay>2020 07 12 00</stdDay>

                <updateDt>null</updateDt>

            </item>

2020/7/12 국내 확진자 현황

같은기관에서 제공하니 내용이 다를일은 없지만

시도별과 응답결과를 비교해봄

일자별 제공이라 그런지 일련번호가 197건인게 눈에 띈다

 

시도별 API에서 합계를 제공하니 큼지막한건 차이가 없는데

음성결과라던지 세세한 부분이 포함되있으니 필요한부분만 이용하면 될것 같다

 

관련글

[programing/API] - 공공데이터API - 보건복지부_코로나19 감염_현황

[programing/API] - 공공데이터API - 보건복지부_코로나19 연령별·성별감염_현황

[programing/GIS] - 공공데이터API - 보건복지부_코로나19 시·도발생_현황

[programing/API] - 공공데이터API - 보건복지부_코로나19해외발생_현황

반응형

관련글 더보기

댓글 영역