굿바이코로나 Corona-19-API 서비스는 코로나바이러스감염증-19 관련 JSON API 서비스를 무제한 무료로 제공합니다.
- 24시간 운영(업타임: https://status.corona-19.kr)
- 빠른 호출
- API 호출 수 제한 없음
- 100% 무료제공
- 공식 자료 사용(ncov.mohw.go.kr)
- 서비스 공지 https://t.me/goodbyecorona
- CORS 지원
서비스 운영을 도와주세요!
굿바이코로나(Corona-19-API) 서비스는 수익 창출이나 광고를 받지 않는 100% 무료서비스 입니다. 도메인 비용, 유지보수 비용 등 서비스 운영에 도움을 주실 수 있습니다.
- https://api.corona-19.kr/ 에 방문해서 이메일 주소, 사용 목적을 입력하신 후 "API 키 발급하기" 버튼을 눌러주세요.
- 버튼을 누르면 즉시 메일로 API 키가 발송됩니다.
- 제공 정보: 국내 확진자수, 국내 완치자수, 국내 사망자수, 국내 격리자수, 확진환자 현황 상위 1-5 시도명 및 퍼센트율, 누적 검사수, 누적 검사완료수, 검사중/결과양성/결과음성 카운터 및 퍼센트 등
- 정보 출처: http://ncov.mohw.go.kr/
- 데이터 동기화 시간: AM 09:45
https://api.corona-19.kr/korea/?serviceKey=APIKey
version | parameter | 항목설명 | 요청 예제 |
---|---|---|---|
v1 | serviceKey | API 인증키 | https://api.corona-19.kr/korea/?serviceKey=fff098a39e0a841ab72e1d27bdee9b517 |
항목명(영어) | 항목명(한글) | 비고 | 샘플데이터 |
---|---|---|---|
resultCode | 응답코드 | 정상(0) / 기타 메시지(오류)는 하단의 공통 오류메시지 참고 | 0 |
TotalCase | 국내 확진자수 | - | 10,237 |
TotalRecovered | 국내 완치자수 | - | 6,463 |
TotalDeath | 국내 사망자수 | - | 183 |
NowCase | 국내 격리자수 | - | 3,591 |
city1n | 시도별 확진환자 현황1(이름) | 시도별 확진환자 현황에서 1번째로 많은 확진환자가 있는 시도의 이름 | 대구 |
city2n | 시도별 확진환자 현황2(이름) | 시도별 확진환자 현황에서 2번째로 많은 확진환자가 있는 시도의 이름 | 경북 |
city3n | 시도별 확진환자 현황3(이름) | 시도별 확진환자 현황에서 3번째로 많은 확진환자가 있는 시도의 이름 | 기타 |
city4n | 시도별 확진환자 현황4(이름) | 시도별 확진환자 현황에서 4번째로 많은 확진환자가 있는 시도의 이름 | 경기 |
city5n | 시도별 확진환자 현황5(이름) | 시도별 확진환자 현황에서 5번째로 많은 확진환자가 있는 시도의 이름 | 서울 |
city1p | 시도별 확진환자 현황1(퍼센트) | 시도별 확진환자 현황에서 1번째로 많은 확진환자가 있는 시도의 퍼센트율 | 66.11 |
city2p | 시도별 확진환자 현황2(퍼센트) | 시도별 확진환자 현황에서 2번째로 많은 확진환자가 있는 시도의 퍼센트율 | 12.84 |
city3p | 시도별 확진환자 현황3(퍼센트) | 시도별 확진환자 현황에서 3번째로 많은 확진환자가 있는 시도의 퍼센트율 | 10.07 |
city4p | 시도별 확진환자 현황4(퍼센트) | 시도별 확진환자 현황에서 4번째로 많은 확진환자가 있는 시도의 퍼센트율 | 5.59 |
city5p | 시도별 확진환자 현황5(퍼센트) | 시도별 확진환자 현황에서 5번째로 많은 확진환자가 있는 시도의 퍼센트율 | 5.39 |
recoveredPercentage | 국내 완치율 | 단위: 퍼센트 | 63.13 |
deathPercentage | 국내 사망률 | 단위: 퍼센트 | 1.79 |
checkingCounter | 국내 검사중 | 단위: 명 | 19,571 |
checkingPercentage | 국내 검사중 | 단위: 퍼센트 | 4.2 |
caseCount | 국내 검사결과 양성 | 단위: 명 | 10,237 |
casePercentage | 국내 검사결과 양성 | 단위: 퍼센트 | 2.2 |
notcaseCount | 국내 검사결과 음성 | 단위: 명 | 431,425 |
notcasePercentage | 국내 검사결과 음성 | 단위: 퍼센트 | 93.5 |
TotalChecking | 총 검사완료 수 | 단위: 명 | 461,233 |
TodayRecovered | 오늘 하루 완치자수 | 단위: 명 | 135 |
TodayDeath | 오늘 하루 사망자수 | 단위: 명 | 2 |
TotalCaseBefore | 전날 대비 환자수 | 단위: 명 | -61 |
source | 데이터 수집 방법 | AUTO_BOT(자동수집), GOODBYE_CORONA(수동적으로 추가되거나 보완된 데이터) | AUTO_BOT |
updateTime | 정보 업데이트 기준 | 00시 정보로 오전 10시경 자동으로 업데이트 됩니다. | 코로나바이러스감염증-19 국내 발생현황 (4.5. 00시 기준) |
resultMessage | API 처리 결과 | 정상처리: (정상 처리되었습니다.) / 오류(Unauthorized) | 정상 처리되었습니다. |
※ JSON 샘플 응답(전문)
- 제공 정보: 전일대비 확진환자 증감, 확진환자수, 격리해제수, 사망자수, 발생률 등
- 정보 출처: http://ncov.mohw.go.kr/
- 데이터 동기화 시간: 즉시
https://api.corona-19.kr/korea/country/new/?serviceKey=APIKey
※ 요청변수 [GET] - v2부터는 데이터가 배열 형태로 제공됩니다.
version | parameter | 항목설명 | 예제 |
---|---|---|---|
v1 | serviceKey | API 인증키 | https://api.corona-19.kr/korea/country/?serviceKey=fff098a39e0a841ab72e1d27bdee9b517 |
v2(recommended) | serviceKey | API 인증키 | http://api.corona-19.kr/korea/country/new/?serviceKey=fff098a39e0a841ab72e1d27bdee9b517 |
항목명(영어) | 항목명(한글) | 비고 | 샘플데이터 |
---|---|---|---|
resultCode | 응답코드 | 정상(0) / 기타 메시지(오류)는 하단의 공통 오류메시지 참고 | 0 |
resultMessage | 정상처리: (정상 처리되었습니다.) / 오류(Unauthorized) | 정상 처리되었습니다. | |
countryName | 시도명(지역명) | 서울 | |
newCase | 신규확진환자수 | 전일대비 | 2 |
totalCase | 확진환자수 | 619 | |
recovered | 완치자수 | 250 | |
death | 사망자 | 2 | |
percentage | 발생률 | 단위: % | 6.36 |
newFcase | 전일대비증감-해외유입 | 1 | |
newCcase | 전일대비증감-지역발생 | 1 |
※ JSON 샘플 응답(전문)
HTTP 응답코드 | 오류메시지 | 설명 |
---|---|---|
401 | serviceKey가 잘못되었습니다. 대소문자, 띄어쓰기를 모두 확인하므로 정확한지 확인하세요. (The serviceKey is invalid. Both upper and lower case letters and spaces are checked, so make sure they are correct.) | GET 요청으로 보낸 serviceKey가 잘못된 상태입니다. 대소문자를 구분하며 띄어쓰기가 있지는 않은지 확인해 주세요. 메일로 발송된 API 키를 정확하게 입력하셔야 합니다. |
403 | 차단된 serviceKey로 이용할 수 없습니다. (It cannot be used with a blocked serviceKey.) | 이용 약관을 위반해 차단된 API 키 입니다. 차단된 경우 서비스 이용이 불가능 합니다. |
500 | 서버 내부 오류(오류명)가 발생했습니다. 관리자에게 문의하세요. (A server internal error (Error name) has occurred. Please contact your administrator.) | 서버 내부 오류가 발생한 상태입니다. 관리자에게 문의해 주세요. |
- 본 서비스는 국가 및 어느 단체에서 운영하는 서비스가 아닙니다.
- 본 서비스는 업타임 100%를 위해 노력하지만 이를 보증하지는 않습니다.
- 본 서비스는 데이터의 정확성을 보장하지 않습니다. (Original Page의 구조 변경 등으로 발생할 수 있는 데이터 오류 등을 책임지지 않음.)
- 굿바이코로나에서 제공하는 코로나19 관련 API는 비상업적 조건으로 무료로 사용할 수 있습니다. (본 서비스를 이용해 프로그램 또는 서비스를 제작하여 판매할 수 없습니다. 그 외 상업적 목적으로도 사용할 수 없습니다.)
- 불법 서비스에서의 API 이용은 금지됩니다.
- 서비스에 부하를 주는 행위는 금지됩니다.
- 키를 받으신 이메일 주소로 서비스 중요 공지사항 등이 발송될 수 있습니다.
- 불법적으로 본 서비스를 해킹/변조하여 이용하는경우 법적 처벌을 받을 수 있습니다.
- 이용약관을 위반할경우 발급하신 KEY가 차단될 수 있습니다.
<굿바이코로나 Corona-19-API 서비스>(' https://api.corona-19.kr' 이하 'Corona-19-API')_은(는) 개인정보보호법에 따라 이용자의 개인정보 보호 및 권익을 보호하고 개인정보와 관련한 이용자의 고충을 원활하게 처리할 수 있도록 다음과 같은 처리방침을 두고 있습니다.
<굿바이코로나 Corona-19-API 서비스>('Corona-19-API')_ 은(는) 회사는 개인정보처리방침을 개정하는 경우 웹사이트 공지사항(또는 개별공지)을 통하여 공지할 것입니다.
○ 본 방침은부터 2020년 4월 1일부터 시행됩니다.
(1). 개인정보의 처리 목적 <굿바이코로나 Corona-19-API 서비스>(' https://api.corona-19.kr' 이하 'Corona-19-API')_은(는) 개인정보를 다음의 목적을 위해 처리합니다. 처리한 개인정보는 다음의 목적이외의 용도로는 사용되지 않으며 이용 목적이 변경될 시에는 사전동의를 구할 예정입니다.
가. 홈페이지 회원가입 및 관리 회원 가입의사 확인, 서비스 부정이용 방지 등을 목적으로 개인정보를 처리합니다.
나. 민원사무 처리 처리결과 통보 등을 목적으로 개인정보를 처리합니다.
(2). 개인정보 파일 현황
- 개인정보 파일명 : 굿바이코로나 Corona-19-API 개인정보
- 개인정보 항목 : 이메일, 접속 IP 정보
- 수집방법 : 홈페이지
- 보유근거 : 안정적인 서비스 운영, 불법이용 방지
- 보유기간 : 시스템 로그 파일(14일), DB(서비스 종료 때 까지)
3. 개인정보의 처리 및 보유 기간
① <굿바이코로나>('Corona-19-API')은(는) 법령에 따른 개인정보 보유·이용기간 또는 정보주체로부터 개인정보를 수집시에 동의 받은 개인정보 보유,이용기간 내에서 개인정보를 처리,보유합니다.
② 각각의 개인정보 처리 및 보유 기간은 다음과 같습니다.
1.<민원사무 처리>
<민원사무 처리>와 관련한 개인정보는 수집.이용에 관한 동의일로부터<서비스 종료까지>까지 위 이용목적을 위하여 보유.이용됩니다.
-보유근거 : 안정적인 서비스 운영, 불법이용 방지
4. 정보주체와 법정대리인의 권리·의무 및 그 행사방법 이용자는 개인정보주체로써 다음과 같은 권리를 행사할 수 있습니다.
① 정보주체는 굿바이코로나에 대해 언제든지 개인정보 열람,정정,삭제,처리정지 요구 등의 권리를 행사할 수 있습니다.
② 제1항에 따른 권리 행사는굿바이코로나에 대해 개인정보 보호법 시행령 제41조제1항에 따라 전자우편을 통하여 하실 수 있으며 굿바이코로나은(는) 이에 대해 지체 없이 조치하겠습니다.
③ 제1항에 따른 권리 행사는 정보주체의 법정대리인이나 위임을 받은 자 등 대리인을 통하여 하실 수 있습니다. 이 경우 개인정보 보호법 시행규칙 별지 제11호 서식에 따른 위임장을 제출하셔야 합니다.
④ 개인정보 열람 및 처리정지 요구는 개인정보보호법 제35조 제5항, 제37조 제2항에 의하여 정보주체의 권리가 제한 될 수 있습니다.
⑤ 개인정보의 정정 및 삭제 요구는 다른 법령에서 그 개인정보가 수집 대상으로 명시되어 있는 경우에는 그 삭제를 요구할 수 없습니다.
⑥ 굿바이코로나은(는) 정보주체 권리에 따른 열람의 요구, 정정·삭제의 요구, 처리정지의 요구 시 열람 등 요구를 한 자가 본인이거나 정당한 대리인인지를 확인합니다.
5. 처리하는 개인정보의 항목 작성
① <굿바이코로나 Corona-19-API 서비스>(' https://api.corona-19.kr' 이하 'Corona-19-API')_은(는) 다음의 개인정보 항목을 처리하고 있습니다.
- <민원사무 처리>
- 필수항목 : 이메일, 접속 IP 정보
6. 개인정보의 파기 <굿바이코로나 Corona-19-API 서비스>('Corona-19-API')_은(는) 원칙적으로 개인정보 처리목적이 달성된 경우에는 지체없이 해당 개인정보를 파기합니다. 파기의 절차, 기한 및 방법은 다음과 같습니다.
-파기절차
이용자가 입력한 정보는 목적 달성 후 별도의 DB에 옮겨져(종이의 경우 별도의 서류) 내부 방침 및 기타 관련 법령에 따라 일정기간 저장된 후 혹은 즉시 파기됩니다. 이 때, DB로 옮겨진 개인정보는 법률에 의한 경우가 아니고서는 다른 목적으로 이용되지 않습니다.
-파기기한
이용자의 개인정보는 개인정보의 보유기간이 경과된 경우에는 보유기간의 종료일로부터 5일 이내에, 개인정보의 처리 목적 달성, 해당 서비스의 폐지, 사업의 종료 등 그 개인정보가 불필요하게 되었을 때에는 개인정보의 처리가 불필요한 것으로 인정되는 날로부터 5일 이내에 그 개인정보를 파기합니다.
-파기방법
전자적 파일 형태의 정보는 기록을 재생할 수 없는 기술적 방법을 사용합니다.
7. 개인정보 자동 수집 장치의 설치•운영 및 거부에 관한 사항
굿바이코로나 Corona-19-API 서비스는 정보주체의 이용정보를 저장하고 수시로 불러오는 ‘쿠키’를 사용하지 않습니다.
8. 개인정보 보호책임자 작성
① <굿바이코로나 Corona-19-API 서비스>(' https://api.corona-19.kr' 이하 'Corona-19-API')_은(는) 개인정보 처리에 관한 업무를 총괄해서 책임지고, 개인정보 처리와 관련한 정보주체의 불만처리 및 피해구제 등을 위하여 아래와 같이 개인정보 보호책임자를 지정하고 있습니다.
▶ 개인정보 보호책임자
성명 :박도현
직책 :운영자
직급 :운영자
이메일 :dhlife09@gmail.com
※ 개인정보 보호 담당부서로 연결됩니다.
② 정보주체께서는 굿바이코로나(‘https://api.corona-19.kr’ 이하 ‘Corona-19-API) 의 서비스(또는 사업)을 이용하시면서 발생한 모든 개인정보 보호 관련 문의, 불만처리, 피해구제 등에 관한 사항을 개인정보 보호책임자로 문의하실 수 있습니다. <굿바이코로나 Corona-19-API 서비스>(' https://api.corona-19.kr' 이하 'Corona-19-API')_은(는) 정보주체의 문의에 대해 지체 없이 답변 및 처리해드릴 것입니다.
9. 개인정보 처리방침 변경
① 이 개인정보처리방침은 시행일로부터 적용되며, 법령 및 방침에 따른 변경내용의 추가, 삭제 및 정정이 있는 경우에는 변경사항의 시행 7일 전부터 공지사항을 통하여 고지할 것입니다.
10. 개인정보의 안전성 확보 조치 <굿바이코로나 Corona-19-API 서비스>('Corona-19-API')은(는) 개인정보보호법 제29조에 따라 다음과 같이 안전성 확보에 필요한 기술적/관리적 및 물리적 조치를 하고 있습니다.
-
접속기록의 보관 및 위변조 방지
개인정보처리시스템에 접속한 기록을 최소 6개월 이상 보관, 관리하고 있으며, 접속 기록이 위변조 및 도난, 분실되지 않도록 보안기능 사용하고 있습니다. -
개인정보에 대한 접근 제한
개인정보를 처리하는 데이터베이스시스템에 대한 접근권한의 부여,변경,말소를 통하여 개인정보에 대한 접근통제를 위하여 필요한 조치를 하고 있으며 침입차단시스템을 이용하여 외부로부터의 무단 접근을 통제하고 있습니다.