24 Sekki API Documentation

Introduction

The 24 Sekki API provides information about the traditional Japanese calendar system that divides the year into 24 solar terms. Each sekki represents a specific seasonal change throughout the year.

Endpoints

Get All Sekki

GET /api/sekki

Returns all 24 sekki with their details.

Example Response:

{
  "count": 24,
  "data": [
    {
      "id": 1,
      "name": {
        "japanese": "立春",
        "romaji": "Risshun",
        "reading": "りっしゅん"
      },
      "season": "spring",
      "color": "#D6E5A8",
      "description": "Beginning of spring. The east wind melts the ice.",
      "approximate_date": "February 4"
    },
    ...
  ]
}

Get Sekki by ID

GET /api/sekki?id=1

Returns a specific sekki by its ID (1-24).

Example Response:

{
  "id": 1,
  "name": {
    "japanese": "立春",
    "romaji": "Risshun",
    "reading": "りっしゅん"
  },
  "season": "spring",
  "color": "#D6E5A8",
  "description": "Beginning of spring. The east wind melts the ice.",
  "approximate_date": "February 4"
}

Get Sekki by Season

GET /api/sekki?season=spring

Returns all sekki for a specific season (spring, summer, autumn, winter).

Example Response:

[
  {
    "id": 1,
    "name": {
      "japanese": "立春",
      "romaji": "Risshun",
      "reading": "りっしゅん"
    },
    "season": "spring",
    "color": "#D6E5A8",
    "description": "Beginning of spring. The east wind melts the ice.",
    "approximate_date": "February 4"
  },
  ...
]

Get Current Sekki

GET /api/sekki?current=true

Returns the currently active sekki based on today's date.

Example Response:

{
  "id": 4,
  "name": {
    "japanese": "春分",
    "romaji": "Shunbun",
    "reading": "しゅんぶん"
  },
  "season": "spring",
  "color": "#A8D193",
  "description": "Spring equinox. Day and night are of equal length.",
  "approximate_date": "March 21",
  "date_range": {
    "start": { "month": 3, "day": 21 },
    "end": { "month": 4, "day": 4 }
  }
}

Seasons and Colors

The 24 Sekki are divided into four seasons, each with its own color scheme: