Metadata-Version: 2.1
Name: hcsapi
Version: 1.15.5
Summary: 자가진단 자동화 비공식 Api (Automation tool for https://hcs.eduro.go.kr/)
Home-page: https://github.com/hcsapi/hcsapi
Download-URL: https://github.com/hcsapi/hcsapi
Author: scottjsh & excutetype
License: GPL-V3
Keywords: korea,covid,auto,hcs
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: >=3.4
Description-Content-Type: text/markdown
License-File: LICENSE

# hcsapi

## 📥다운로드
git을 통해 리포지토리 코드를 설치하실 수 있습니다.

> 윈도우나 리눅스의 터미널에서 다음과 같이 입력합니다.
> ```shell
> python -m pip install -U pip
> pip install hcsapi
> ```
> 또는
> ```shell
> python -m pip install -U pip
> pip install git+https://github.com/hcsapi/hcsapi.git@main
> ```
> **업데이트**
> pip install hcsapi --upgrade

## 🤖사용 방법
[이곳의 예제](./example)를 참고하세요.

<details><summary>지원하는 모든 지역이름 보기</summary>
<p>
지원하는 지역 이름은 다음과 같습니다: 

'서울', '서울시', '서울교육청', '서울시교육청', '서울특별시'</br>
'부산', '부산광역시', '부산시', '부산교육청', '부산광역시교육청'</br> 
'대구', '대구광역시', '대구시', '대구교육청', '대구광역시교육청'</br> 
'인천', '인천광역시', '인천시', '인천교육청', '인천광역시교육청'</br> 
'광주', '광주광역시', '광주시', '광주교육청', '광주광역시교육청'</br> 
'대전', '대전광역시', '대전시', '대전교육청', '대전광역시교육청'</br> 
'울산', '울산광역시', '울산시', '울산교육청', '울산광역시교육청'</br> 
'세종', '세종특별시', '세종시', '세종교육청', '세종특별자치시', '세종특별자치시교육청'</br> 
'경기', '경기도', '경기교육청', '경기도교육청'</br> 
'강원', '강원도', '강원교육청', '강원도교육청'</br> 
'충북', '충청북도', '충북교육청', '충청북도교육청'</br> 
'충남', '충청남도', '충남교육청', '충청남도교육청'</br> 
'전북', '전라북도', '전북교육청', '전라북도교육청'</br> 
'전남', '전라남도', '전남교육청', '전라남도교육청'</br> 
'경북', '경상북도', '경북교육청', '경상북도교육청'</br> 
'경남', '경상남도', '경남교육청', '경상남도교육청'</br> 
'제주', '제주도', '제주특별자치시', '제주교육청', '제주도교육청', '제주특별자치시교육청', '제주특별자치도'
</p>
</details>

<details><summary>지원하는 모든 학교종류 보기</summary>
<p>
지원하는 학교급 이름은 다음과 같습니다: 

'유치원', '유','유치'</br>
'초등학교', '초','초등'</br> 
'중학교', '중','중등'</br> 
'고등학교', '고','고등'</br>
'특수학교', '특','특수','특별'
</p>
</details>

## ↩️리턴값

모든 리턴값은 Dict로 반환됩니다.</br>
리턴값 구조는 다음과 같습니다: </br>
```
{"error":Boolean(True,False),'code':"처리코드(밑의 처리코드 종류 참조)","message":"해당 에러나, 성공 상황에 대한 설명"}
```

<details><summary>처리코드 종류</summary>
성공 = "SUCCESS"</br>  
존재하지 않는 지역, 학교급 = "FORMET"</br>  
학교 검색 실패 = "NOSCHOOL"</br>  
학생 검색 실패 = "NOSTUDENT"</br>  
알 수 없는 에러 = "UNKNOWN" 
</details>

## 💡 TIP
리턴값의 `'code'` 를 이용하시면 성공, 실패 여부, 실패 이유를 모두 알 수 있습니다.</br>
또한 `'message'`로 이용자에게 바로 실패 이유를 알릴 수 있습니다.


**원본 소스의 저작권은 331leo님에게 있습니다.**
**코드 일부분(transkey 부분)의 저작권은 blluv 님에게 있습니다.**


