APIFuseAPIFuse
문서서비스플레이그라운드상태
로그인회원가입

Service

일본 공휴일

일본, 캘린더제공 중
Playground에서 시험API 레퍼런스 열기

Overview

일본 내각부의 공식 공휴일 CSV와 법정 연말연시 공공기관 휴무를 사용해 공휴일 목록 조회, 날짜 확인, 다음 공휴일 검색, 일본 공공기관 영업일 계산을 제공합니다.

Status

중단

96.67%30일 가동률평균 응답49ms

2026-09-262026-10-112026-10-25

Setup

Auth mode
Managed key
Credentials
  • japan-public-holidays scope가 허용된 managed key
Sandbox
미제공

APIs

행을 선택하면 해당 API의 레퍼런스로 이동합니다.

MethodAPIPathSummary
POST/v1/japan-public-holidays/holidayCheck whether one covered ISO date is an official Japanese public holiday and return its official holiday record when present. Use when the question is only about a date's holiday status or the holiday's name and type. Do NOT use to decide whether a public office is open on that date — use japan-public-holidays:office-business-day instead. date is read as a Japan Standard Time (JST, UTC+09:00) calendar date. Returns is_holiday, holiday (the record, or null for a non-holiday), coverage_start_date, and coverage_end_date.
POST/v1/japan-public-holidays/holidaysList the official Japanese public holidays in one calendar year. Use when the user needs every holiday in a year or wants to browse a year's holiday names and types. Do NOT use to check a single date — use japan-public-holidays:holiday instead. Years are limited to the Cabinet Office source coverage, which starts in 1955. The year is the Japan Standard Time (JST, UTC+09:00) calendar year. Returns items, summary, coverage_start_date, and coverage_end_date.
POST/v1/japan-public-holidays/next-holidayFind the next official Japanese public holiday after from_date within the Cabinet Office source coverage; set include_from_date to true to allow a holiday on from_date itself. Use when the user asks when the next holiday is or how many days remain until it. Do NOT use to move a date by public-office business days — use japan-public-holidays:office-business-day-shift instead. from_date is read as a Japan Standard Time (JST, UTC+09:00) calendar date, and days_until counts JST calendar days. Returns holiday, days_until, and coverage_end_date.
POST/v1/japan-public-holidays/office-business-dayCheck whether one date is a Japanese public-office business day, treating weekends, official public holidays, and the December 29 through January 3 office closure as non-business days. Use when the question is whether a Japanese government office is open on a date. Do NOT use when only the holiday status or holiday name matters — use japan-public-holidays:holiday instead. This does not model bank or private-company calendars. date is read as a Japan Standard Time (JST, UTC+09:00) calendar date, so the weekend is Japan's. Returns is_business_day, reason, and holiday (the record only when reason is public_holiday; otherwise null).

Related guides

  • sandbox key를 발급받고 첫 예약 생성까지 진행합니다.

  • 파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.

  • 예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.

  • 서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.

POST/v1/japan-public-holidays/office-business-day-shiftMove forward or backward from start_date by a number of Japanese public-office business days, skipping weekends, official public holidays, and the December 29 through January 3 office closure. Use when the user needs the date that is N public-office business days before or after a given date. Do NOT use to check a single date — use japan-public-holidays:office-business-day instead. Do NOT use to find the next public holiday — use japan-public-holidays:next-holiday instead. Counting starts on the date adjacent to start_date, every date must stay within the source coverage, and this does not model bank or private-company calendars. start_date, result_date and every skipped date are Japan Standard Time (JST, UTC+09:00) calendar dates. Returns result_date and skipped_dates.
일본 공휴일 조회
일본 공휴일 목록
다음 일본 공휴일 조회
일본 공공기관 영업일 확인
빠른 시작
Managed key
개요
에러 모델
일본 공공기관 영업일 더하기