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