공휴일·영업일
주말은 달력으로 바로 답하고, 공휴일은 한국천문연구원 특일 정보로 확인한다. N영업일 뒤 날짜를 계산한다
npm install @duolabs-deux/unit-holidays
직접 넣어 보기
환경변수
| 이름 | 설명 | |
|---|---|---|
DATA_GO_KR_SERVICE_KEY | 필수 | 공공데이터포털 일반 인증키(Decoding). 「한국천문연구원_특일 정보」 활용신청이 필요하다. 계정 하나에 키 하나라 다른 공공데이터 유닛과 같은 키를 쓴다 |
어댑터
| id | 종류 | 설명 |
|---|---|---|
kasi | 실제 | 한국천문연구원 공휴일 조회(getRestDeInfo). 한 해를 한 번에 받는다 |
fake | 가짜 | 양력 고정 공휴일 8개만 안다. 설·추석·대체·임시공휴일이 없다 |
실패와 소비 앱이 할 일
| 종류 | 언제 | 할 일 |
|---|---|---|
invalid-input | 읽을 수 없거나 없는 날짜, 영업일 수가 ±366 을 넘을 때 | 입력 칸에서 바로 알린다 |
auth | 키가 없거나, 이 API 활용신청을 안 했을 때(결과 코드 20·30·31·32, HTTP 401·403) | 운영자에게 알린다 |
quota | 하루 호출 한도를 넘었을 때(결과 코드 22) | 캐시가 한 해 치를 하루 동안 두므로 보통 걸리지 않는다 |
timeout | 5초 안에 답이 없을 때(1회 재시도 뒤) | 주말 판정은 여전히 된다. 평일 판정만 보류한다 |
upstream-down | 천문연구원·포털 서버 오류 | timeout 과 같다 |
unexpected | 응답에 header 가 없거나 형식이 다를 때 | 명세가 바뀌었는지 사람이 본다 |
한도
- 개발계정 하루 10,000건(공공데이터포털 안내)
- 다음다음 해 자료는 보통 그해 여름에 올라온다
- 임시공휴일은 지정 뒤 하루 안에 반영된다고 안내돼 있다