API の使い方

元号くんは無料の JSON API として、西暦・和暦・干支の情報や日本の祝日データを提供しています。

public

認証不要で利用できます。商用利用も可能です。

data_object

フィールド名はわかりやすく、レスポンスは平坦な構造です。

lock_open

ブラウザから直接呼び出せます (Access-Control-Allow-Origin: *)。

ベース URL

全てのエンドポイントは https://seireki.teraren.com を起点とします。HTTPS のみサポートしています。

BASE https://seireki.teraren.com

GET /seireki/2024.json 西暦から和暦への変換

リクエスト例

curl -sH "Accept: application/json" \
  https://seireki.teraren.com/seireki/2024.json

レスポンス例

{"seireki":"2024年","wareki":"令和6年","eto":"辰","age":2,"url":"https://seireki.teraren.com/seireki/2024.json"}

GET /wareki/2024.json 和暦の年情報を取得

リクエスト例

curl -sH "Accept: application/json" \
  https://seireki.teraren.com/wareki/2024.json

レスポンス例

{"seireki":"2024年","wareki":"令和6年","eto":"辰","age":2,"url":"https://seireki.teraren.com/seireki/2024.json"}

GET /holiday/2024.json 指定年の祝日一覧 (JSON)

リクエスト例

curl -sH "Accept: application/json" \
  https://seireki.teraren.com/holiday/2024.json

レスポンス例

[{"date":"2024-01-01","name":"元日"},{"date":"2024-01-08","name":"成人の日"}, ...]

GET /holiday/2024.ics 指定年の祝日一覧 (iCalendar)

リクエスト例

curl -sH "Accept: application/json" \
  https://seireki.teraren.com/holiday/2024.ics

レスポンス例

BEGIN:VCALENDAR\nVERSION:2.0\nPRODID:icalendar-ruby\n... (iCalendar feed)

西暦・和暦は JSON、祝日は JSON と iCalendar (.ics) に対応しています。`.json` または `.ics` 拡張子をパスに付けてください。

西暦・和暦は1〜3000年（和暦は対応元号のみ）、祝日は1970年以降をサポートしています。