📘 Kichijitsu Calendar API ドキュメント

🌸 基本情報

• ベースURL： https://api.omajinai.co.jp
• 主要エンドポイント： /rapid.php, /rapid/*
• 認証： RapidAPIキー（自動）または Authorization: Bearer <TOKEN> / ?token=
• タイムゾーン： Asia/Tokyo (UTC+9)
• OpenAPI： openapi.yaml

🧭 使い方（2通り）

1. RapidAPIから呼ぶ： キーは自動付与されます。
2. 直接呼ぶ（Pro以上）： ヘッダ Authorization: Bearer YOUR_TOKEN またはクエリ ?token=YOUR_TOKEN を付与。

📅 エンドポイント

1) /rapid.php（クエリスタイル）

GET /rapid.php?fn=day&date=2026-01-01&view=lite

• fn: health / day / range / bulk
• view: lite | pro（省略時は lite）
• date: YYYY-MM-DD（fn=day）
• start, end: YYYY-MM-DD（fn=range）
• years: 例 2025,2026（fn=bulk, Pro）

2) Pretty URL

読みやすいパス形式でも同じ結果が得られます。

• GET /rapid/day/2026-01-01?view=pro
• GET /rapid/range/2026-01-01/2026-01-07?view=lite
• GET /rapid/bulk/2025,2026（Pro）

🔐 認証（Authentication）

Rapid経由ではヘッダに X-RapidAPI-Key が自動付与されます。直接呼び出す場合は、以下のいずれか。

Authorization: Bearer YOUR_TOKEN
# あるいは
?token=YOUR_TOKEN

🧩 レスポンス例

Day（lite）

{
  "ok": true,
  "view": "lite",
  "date": "2026-01-01",
  "day": {
    "iso": "2026-01-01",
    "y": 2026, "m": 1, "d": 1,
    "youbi": "木",
    "holiday": "元日",
    "rokuyou": "大安",
    "kyureki": "11月13日",
    "sekki": "小寒",
    "moonmark": ""
  }
}

Day（pro）

{
  "ok": true,
  "view": "pro",
  "date": "2026-01-01",
  "day": {
    "iso": "2026-01-01",
    "y": 2026, "m": 1, "d": 1,
    "nengo": "令和8年",
    "youbi": "木",
    "holiday": "元日",
    "rokuyou": "大安",
    "kyusei": "三碧木星",
    "eto": "乙亥",
    "junichoku": "閉",
    "shuku28": "井",
    "kou72": "芹乃栄",
    "kyureki": "11月13日",
    "sekki": "小寒",
    "notes_arr": ["一粒万倍日","不成就日","重日"],
    "periods": [
      { "name":"天一天上", "from":"2026-01-12", "to":"2026-01-27", "includes_end":true }
    ]
  }
}

⏱️ レート制限とキャッシュ

• レート制限（429）はRapid契約や内部設定に依存
• キャッシュヘッダ Cache-Control / 条件付き ETag / Last-Modified を返す場合があります

⚠️ 注意事項

• 暦・運勢データは情報提供・エンタメ目的であり、結果の正確性を保証しません。
• 商用利用は Pro 以上 が必要です。