Back to top

API Documentation

特定日付の情報取得

特定日付の情報取得（YYYYMMDD形式）

ISO8601基本形式
GET/{YYYYMMDD}

処理概要

  • 指定した日付に該当する国民の祝日/国民の休日/振替休日が存在する場合、国民の祝日/国民の休日/振替休日の情報を返す。

  • 指定した日付に該当する国民の祝日/国民の休日/振替休日が存在しない場合、NotFoundを返す。

Example URI

GET /20200223
URI Parameters
HideShow
YYYYMMDD
string (required) Example: 20200223

日付（ISO8601基本形式）

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "date": "2020-02-23",
  "name": "天皇誕生日",
  "type": "国民の祝日"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "日付(ISO8601拡張形式)"
    },
    "name": {
      "type": "string",
      "description": "国民の祝日の名称（または国民の休日, 振替休日）"
    },
    "type": {
      "type": "string",
      "enum": [
        "国民の祝日",
        "国民の休日",
        "振替休日"
      ],
      "description": "種別"
    }
  },
  "required": [
    "date",
    "name",
    "type"
  ]
}

特定日付の情報取得（YYYY-MM-DD形式）

ISO8601拡張形式
GET/{date}

処理概要

  • 指定した日付に該当する国民の祝日/国民の休日/振替休日が存在する場合、国民の祝日/国民の休日/振替休日の情報を返す。

  • 指定した日付に該当する国民の祝日/国民の休日/振替休日が存在しない場合、NotFoundを返す。

Example URI

GET /2020-11-03
URI Parameters
HideShow
date
string (required) Example: 2020-11-03

日付（ISO8601拡張形式）

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "date": "2020-11-03",
  "name": "文化の日",
  "type": "国民の祝日"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "日付（ISO8601拡張形式）"
    },
    "name": {
      "type": "string",
      "description": "国民の祝日の名称（または国民の休日, 振替休日）"
    },
    "type": {
      "type": "string",
      "enum": [
        "国民の祝日",
        "国民の休日",
        "振替休日"
      ],
      "description": "種別"
    }
  },
  "required": [
    "date",
    "name",
    "type"
  ]
}

特定日付の情報取得（YYYY/MM/DD形式）

YYYY/MM/DD形式
GET/{YYYY}/{MM}/{DD}

処理概要

  • 指定した日付に該当する国民の祝日/国民の休日/振替休日が存在する場合、国民の祝日/国民の休日/振替休日の情報を返す。

  • 指定した日付に該当する国民の祝日/国民の休日/振替休日が存在しない場合、NotFoundを返す。

Example URI

GET /2020/05/03
URI Parameters
HideShow
YYYY
string (required) Example: 2020

西暦年（4桁）

MM
string (required) Example: 05

月（ゼロ埋め2桁）

DD
string (required) Example: 03

日（ゼロ埋め2桁）

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "date": "2020-05-03",
  "name": "憲法記念日",
  "type": "国民の祝日"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "日付（ISO8601拡張形式）"
    },
    "name": {
      "type": "string",
      "description": "国民の祝日の名称（または国民の休日, 振替休日）"
    },
    "type": {
      "type": "string",
      "enum": [
        "国民の祝日",
        "国民の休日",
        "振替休日"
      ],
      "description": "種別"
    }
  },
  "required": [
    "date",
    "name",
    "type"
  ]
}

特定日付の情報取得（和暦形式）

JIS X 0301形式
GET/{N}{yy}.{MM}.{DD}

処理概要

  • 指定した日付に該当する国民の祝日/国民の休日/振替休日が存在する場合、国民の祝日/国民の休日/振替休日の情報を返す。

  • 指定した日付に該当する国民の祝日/国民の休日/振替休日が存在しない場合、NotFoundを返す。

Example URI

GET /R02.04.29
URI Parameters
HideShow
N
enum (required) Example: R

元号（アルファベット表記での頭文字）

  • M (string) - 明治

  • T (string) - 大正

  • S (string) - 昭和

  • H (string) - 平成

  • R (string) - 令和

yy
string (required) Example: 02

年（ゼロ埋め2桁）

MM
string (required) Example: 04

月（ゼロ埋め2桁）

DD
string (required) Example: 29

日（ゼロ埋め2桁）

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "date": "2020-04-29",
  "name": "昭和の日",
  "type": "国民の祝日"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "日付（ISO8601拡張形式）"
    },
    "name": {
      "type": "string",
      "description": "国民の祝日の名称（または国民の休日, 振替休日）"
    },
    "type": {
      "type": "string",
      "enum": [
        "国民の祝日",
        "国民の休日",
        "振替休日"
      ],
      "description": "種別"
    }
  },
  "required": [
    "date",
    "name",
    "type"
  ]
}

特定年月の一覧取得

特定年月の一覧取得（YYYYMM形式）

YYYYMM形式
GET/{YYYYMM}

処理概要

  • 指定した年月に該当する国民の祝日/国民の休日/振替休日が存在する場合、国民の祝日/国民の休日/振替休日のリストを返す。

  • 指定した年月に該当する国民の祝日/国民の休日/振替休日が存在しない場合、NotFoundを返す。

Example URI

GET /202002
URI Parameters
HideShow
YYYYMM
string (required) Example: 202002

年月（区切り文字なし）

Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "date": "2020-02-11",
    "name": "建国記念の日",
    "type": "国民の祝日"
  },
  {
    "date": "2020-02-23",
    "name": "天皇誕生日",
    "type": "国民の祝日"
  }
]

特定年月の一覧取得（YYYY-MM形式）

YYYY-MM形式
GET/{YYYY}-{MM}

処理概要

  • 指定した年月に該当する国民の祝日/国民の休日/振替休日が存在する場合、国民の祝日/国民の休日/振替休日のリストを返す。

  • 指定した年月に該当する国民の祝日/国民の休日/振替休日が存在しない場合、NotFoundを返す。

Example URI

GET /2020-11
URI Parameters
HideShow
YYYY
string (required) Example: 2020

西暦年（4桁）

MM
string (required) Example: 11

月（ゼロ埋め2桁）

Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "date": "2020-11-03",
    "name": "文化の日",
    "type": "国民の祝日"
  },
  {
    "date": "2020-11-23",
    "name": "勤労感謝の日",
    "type": "国民の祝日"
  }
]

特定年月の一覧取得（YYYY/MM形式）

YYYY/MM形式
GET/{YYYY}/{MM}

処理概要

  • 指定した年月に該当する国民の祝日/国民の休日/振替休日が存在する場合、国民の祝日/国民の休日/振替休日のリストを返す。

  • 指定した年月に該当する国民の祝日/国民の休日/振替休日が存在しない場合、NotFoundを返す。

Example URI

GET /2020/05
URI Parameters
HideShow
YYYY
string (required) Example: 2020

西暦年（4桁）

MM
string (required) Example: 05

月（ゼロ埋め2桁）

Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "date": "2020-05-03",
    "name": "憲法記念日",
    "type": "国民の祝日"
  },
  {
    "date": "2020-05-03",
    "name": "みどりの日",
    "type": "国民の祝日"
  },
  {
    "date": "2020-05-05",
    "name": "こどもの日",
    "type": "国民の祝日"
  },
  {
    "date": "2020-05-06",
    "name": "振替休日",
    "type": "振替休日"
  }
]

特定年の一覧取得

特定年の一覧取得（YYYY形式）

西暦年形式
GET/{YYYY}

処理概要

  • 指定した年に該当する国民の祝日/国民の休日/振替休日が存在する場合、国民の祝日/国民の休日/振替休日のリストを返す。

  • 指定した年に該当する国民の祝日/国民の休日/振替休日が存在しない場合、NotFoundを返す。

Example URI

GET /1949
URI Parameters
HideShow
YYYY
string (required) Example: 1949

西暦年（4桁）

Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "date": "1949-09-23",
    "name": "秋分の日",
    "type": "国民の祝日"
  },
  {
    "date": "1949-11-03",
    "name": "文化の日",
    "type": "国民の祝日"
  },
  {
    "date": "1949-11-23",
    "name": "勤労感謝の日",
    "type": "国民の祝日"
  }
]

直近取得

今年と来年の国民の祝日の一覧を取得

直近取得
GET/recent

処理概要

  • 今年と来年の国民の祝日/国民の休日/振替休日のリストを返す。

Example URI

GET /recent
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
    {
        "date": "2023-01-01",
        "name": "元日",
        "type": "国民の祝日"
    },
    ... （途中省略） ...
    {
        "date": "2024-11-23",
        "name": "勤労感謝の日",
        "type": "国民の祝日"
    }
]

全件取得

全ての国民の祝日の一覧を取得

全件取得
GET/all

処理概要

  • 全ての国民の祝日/国民の休日/振替休日のリストを返す。

Example URI

GET /all
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
    {
        "date": "1949-09-23",
        "name": "秋分の日",
        "type": "国民の祝日"
    },
    ... （途中省略） ...
    {
        "date": "2020-11-23",
        "name": "勤労感謝の日",
        "type": "国民の祝日"
    }
]

Generated by aglio on 14 Oct 2023