四柱推命API › 万歳暦API

万歳暦API

生年月日時（と性別・タイムゾーン）を送ると、節気から計算した四柱推命（サジュ）の命式、つまり四柱（年・月・日・時）を、その分析と大運・年運とともにJSONで返します。四柱推命は、この四柱から人生を読み解く韓国の体系で、万歳暦（マンセリョク）は四柱を調べるための暦です。商品名は「万歳暦」で、同じレスポンスに Saju Identity（四柱アイデンティティ）も含まれます。結果はルールで計算するため、同じ入力ならいつも同じ結果になります。

はじめにガイドキーなしで試す料金

返すもの

命式の四柱 — 年柱・月柱・日柱・時柱それぞれの天干と地支、五行、通変星（各文字が自分に対して担う関係上の役割）、蔵干、十二運星、納音、神殺（象徴的な星） (wonkuk)
命式の分析 — 五行のバランス、用神（喜ぶ五行）、格局（命式の構造）、日干の強弱、沖・合・刑、空亡 (ohaengBalance·yongshin·gyeokguk·strength·branchRelations·gongmang)
運の周期 — 大運の一覧とその開始年齢・方向、今年の年運（歳運）と命式との関係 (daeun·seun)
Saju Identity — 神殺の一覧、空亡、三災（3年続く凶運の周期）、タイムラインなど、解釈のためのヒント (identity)

出生時刻がわからない場合

hour と minute は省略できます。 hour を省略すると、正午とはみなさず、時柱を除きます。用神・格局・日干の強弱などの分析フィールドは年・月・日の三柱から計算され、レスポンスの birthHour には三柱にもとづくことが示されます。

リクエスト例

curl -X POST https://api.hrum.ai/api/v1/partners/v1/manseryeok \
  -H "X-Partner-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 2000, "month": 1, "day": 15, "hour": 14, "minute": 30,
    "gender": "male", "calendar": "solar", "timezone": "Asia/Seoul"
  }'

認証は X-Partner-Api-Key ヘッダーで行い、ベースURLは https://api.hrum.ai/api/v1/partners/v1です。Python と JavaScript の例、エラー処理ははじめにガイドにあります。

レスポンス例（抜粋）

{
  "success": true,
  "data": {
    "wonkuk": {
      "year": {
        "stem": "기", "branch": "묘", "stemHanja": "己", "branchHanja": "卯",
        "ohaeng": "토", "stemSipsin": "정관", "branchSipsin": "상관",
        "jijanggan": ["갑", "을"], "chunghyung": [], "hapPosition": ["半合(반합)"],
        "ungSung": "사", "napEum": "성두토",
        "majorSinsal": ["장성살"],
        "minorSinsal": ["천을귀인", "귀문관살", "원진살", "현침살", "육해살"]
      },
      "month": { ... },
      "day": { ... },
      "hour": { ... }
    },
    "trueSolarTime": null,
    "ohaengBalance": { "목": 1, "화": 2, "토": 3, "금": 1, "수": 1 },
    "yongshin": "수",
    "johuYongshin": "화",
    "yongshinDetail": {
      "method": "억부",
      "primary": "수",
      "secondary": ["금"],
      "reasoning": ["일간 임(수) 신약", "신약 + root 있음(8) → 비겁(수)"],
      "shin": { "yongshin": "수", "huishin": "금", "gishin": "토", "gushin": "화", "hanshin": "목" },
      "favorable_sipsin": ["편인", "정인", "비견", "겁재"],
      "unfavorable_sipsin": ["편관", "정관", "편재", "정재", "식신", "상관"],
      "element_states": { "목": { "count": 1, "state": "lack", "effect": "neutral" }, "...": "5오행" }
    },
    "eokbuYongshin": "수",
    "ilganSummary": "壬水 — 큰 바다의 기운. 지혜롭고 포용력이 넓어요.",
    …

2000-01-15 14:30生まれの男性のレスポンスの冒頭です。運の周期・格局・日干の強弱を含むレスポンス全体とフィールドの説明はリファレンスにあります。

料金

万歳暦は1回 ₩50 です（VAT別、VAT込み ₩55）。成功した呼び出しだけがプリペイドのクレジットから差し引かれ、4xx・5xx のエラーレスポンスは課金されません。

一度受け取った結果は保存して再利用してください。 同じリクエストをもう一度送ると、また課金されます。同じ生年月日時と同じオプションならいつも同じ結果なので、最初のレスポンスをデータベースに保存し（例：リクエストボディのハッシュをキーに）、以降は保存した値を無料で使ってください。今日の運勢のように日付で変わる結果は、日付をキーに含め、その日のあいだだけ再利用してください。

料金一覧 · キーがなくても、プレイグラウンドでIPごとに月5回まで試せます。

リファレンス全体

パラメータ表の全体、レスポンスフィールドの説明、エラーコードはリファレンスにあります: 万歳暦API リファレンス · Saju Identity のフィールド。ほかの四柱推命商品は四柱推命APIすべてにあります。

お問い合わせ: contact@float.do · 運営: FLOAT Co., Ltd.