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

출처 :  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해외발생_현황