다음 공휴일
지정한 현지 민간 달력 날짜 이후의 공휴일 하나를 찾습니다.
요청
Narwhal 키로 게시된 국가 연도에 사용할 수 있습니다. 범위와 적용 대상 확인 날짜를 요청하기 전에.
GET /v1/calendars/holidays/{country}/next?from_date={from_date}curl "https://api.narwhalapi.com/v1/calendars/holidays/IDN/next?from_date=2026-08-01" \
-H "Authorization: Bearer $NARWHAL_API_KEY"매개변수
| 이름 | 유형 | 규칙 |
|---|---|---|
country | 문자열 | 필수 경로 값입니다. IDN과 같은 지원되는 대문자 ISO alpha-3 코드 하나입니다. |
from_date | 날짜 문자열 | 필수 쿼리 값 YYYY-MM-DD이며 연도는 1900~2200입니다. 오늘 날짜를 자동 기본값으로 사용하지 않습니다. |
scope | 문자열 | 선택적 쿼리 필터입니다: national_public, regional_public, bank, federal_government, central_government, collective_leave, public_sector 또는 private_sector. 게시된 모든 범주를 반환하려면 생략하세요. |
하위 지역 필터나 페이지 매김이 없습니다. MCP 입력 객체는 추가 필드를 거부합니다.
예시 응답
{
"country": "IDN",
"from_date": "2026-08-01",
"coverage": [
{
"scope": "national_public",
"nationwide": true,
"subdivision_codes": []
},
{
"scope": "collective_leave",
"nationwide": true,
"subdivision_codes": []
}
],
"holiday": {
"date": "2026-08-17",
"name": "Independence Day",
"local_name": "Hari Kemerdekaan",
"subdivision_codes": [],
"nationwide": true,
"observed": null,
"scope": "national_public"
}
}시작일은 포함됩니다. 현재 연도를 검색하고 필요한 경우에만 다음 연도를 검색합니다. 필수 데이터 범위가 없으면 503을 반환합니다. 2200년 이후는 검색하지 않으며 해당 최댓값 연도에도 남은 이벤트가 없으면 holiday: null을 반환합니다. 지역 공휴일을 반환할 수 있습니다. 여러 이벤트가 가장 이른 날짜를 공유하면 안정 정렬에서 첫 번째 항목이 선택되며 모두 가져오려면 날짜 엔드포인트를 사용하세요.
공유 공휴일 필드 모든 이벤트에는 국가 또는 지역 적용 범위가 명시되어 있습니다.
대응하는 MCP 호출
인증된 요청 전송 POST /mcp 다음과 함께 Accept: application/json, text/event-stream.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendars_get_next_holiday",
"arguments": {
"country": "IDN",
"from_date": "2026-08-01"
}
}
}성공한 결과에는 다음이 있습니다 isError: false, 동일한 응답을 structuredContent, 그리고 직렬화된 JSON으로 content[0].text 도메인 오류에는 다음이 있습니다: isError: true.
오류 및 할당량
잘못된 입력은 400을 반환하고, 누락되었거나 잘못된 키는 401을 반환합니다. 연결되지 않은 경로는 404를 반환합니다. 속도 또는 할당량 소진은 429를 반환합니다. 누락·잘못되었거나 철회된 달력은 다음을 반환합니다 503 calendar_coverage_unavailable.
성공한 호출 하나는 이벤트 수나 조회 연도와 관계없이 월간 요청 1회를 소비합니다. 오류는 월간 할당량을 소비하지 않습니다. 공유 오류 세부 정보.