공휴일 정보
날짜와 공휴일 정보를 일관된 형태로 돌려주고, 적용한 달력 규칙을 문서에 명시할 계획입니다.
KOREAPIS
매번 다시 만들지 않아도 되는 날짜 계산.
한국 공휴일과 영업일 계산을 위한 개발자 API를 기획하고 있습니다. 응답 형식과 오류 처리 방식을 일관되게 제공하는 것이 첫 목표입니다.
MVP 기획 · 개발 준비
기획 중인 API 표면
날짜 규칙을 예측 가능한 API 계약으로.
MVP는 일관된 요청, 명시적인 날짜 규칙, 달력 로직을 다시 만들지 않고도 사용할 수 있는 응답을 중심으로 설계하고 있습니다.
- 01 · 요청날짜 범위, 로케일, 영업일 규칙
- 02 · 계산버전이 관리되는 공휴일·영업일 로직
- 03 · 검증명시적인 파라미터와 오류 응답
- 04 · 반환일정과 폼에 연결할 수 있는 JSON
한국 서비스에 필요한 날짜 API
첫 범위는 한국 서비스 개발에서 반복되는 달력 계산에 집중합니다.
영업일 계산
날짜와 방향을 받아 다음 또는 이전 영업일을 계산합니다. 월말·연말 같은 경계 조건도 명세에 포함합니다.
예측 가능한 연동
JSON 응답과 오류 동작을 함께 설계합니다. API 키와 호출량 제한도 함께 설계하고 있습니다.
날짜를 보내고 계산 결과를 받는 과정
입력 날짜와 계산 방향에 따라 같은 결과를 내는 API를 기획합니다.
-
01
계산 조건 입력
날짜, 계산 방향, 원하는 결과를 정합니다.
-
02
검증한 규칙 적용
계산은 정해진 달력·공휴일 규칙을 따르도록 설계합니다.
-
03
결과 확인
결과 또는 문서화된 오류 코드를 받습니다.
제안 인터페이스 · 운영 엔드포인트 아님
GET /v1/business-days/next?date={input-date}
200 { "date": "{calculated-date}" }
오류도 정해진 JSON 형식으로 반환할 계획입니다.
Claude로 연동 문서를 더 쉽게 이해하도록
날짜 계산은 정해진 규칙과 테스트로 검증합니다. Claude 기반 연동 안내는 Findoc의 계획된 API 검증 이후에 검토할 수 있습니다.
현재: Codex 기획 활용
Codex로 요구사항과 API 명세 초안을 정리하고, 월말·연말·잘못된 날짜 입력을 검증할 테스트를 설계합니다. Claude Code는 일부 개발 흐름에서 평가 중입니다.
계획: 연동 안내
Findoc의 계획된 API 검증 이후, API가 구현되면 질문과 비밀 키를 제거한 오류 코드, 공개 명세를 Claude API에 전달해 연동 예제와 수정할 부분을 설명하는 기능을 검토할 수 있습니다.
답변의 근거 확인
안내에는 참고한 명세를 표시하고, 예제 코드는 테스트 후 사용하도록 설계합니다. 날짜 결과는 API 계산 로직이 담당하며 Claude의 설명으로 바꾸지 않습니다.
자주 묻는 질문
지금 API를 쓸 수 있나요?
아닙니다. KoreAPIs는 MVP 기획과 개발 준비 단계이며 예시 인터페이스는 운영 엔드포인트가 아닙니다.
정확성은 어떻게 확인하나요?
달력 규칙과 경계 조건을 테스트하고, 향후 Claude 안내는 명세와 일치하는지와 예제가 실제로 실행되는지를 평가할 계획입니다.
제품 문의