四柱推命API › 生涯四柱API

生涯四柱API

生年月日時を送ると、四柱推命（サジュ）の命式を計算し、その命式に合う解釈の段落を性格・財運・仕事・恋愛・健康・人間関係・アドバイスの7テーマに分けてJSONで返します。四柱推命は、生まれた年・月・日・時から人を読み解く韓国の体系です。商品名は「生涯四柱」です。段落はHRUMの四柱推命理論であらかじめ書かれているため、同じ入力ならいつも同じ結果になります。

はじめにガイドプレイグラウンド料金

7テーマすべて、または1つだけ

topic を省略すると7テーマすべてを、 personality・wealth・career・love・health・relationships・advice のどれかを送るとそのテーマだけを受け取れます。テーマ内の段落は、日柱、日干（生まれた日の天干）× 月支、日干の強弱、用神（喜ぶ五行）、五行の状態、通変星のグループの順に並びます。

西洋占星術と紫微斗数のレイヤー

layers: ["astro", "ziwei"] を送ると、テーマごとに西洋占星術の段落（太陽・月・アセンダントのサイン）と紫微斗数の段落（命宮の主星。財運・仕事・恋愛・健康のテーマでは、そのテーマを受け持つ宮の主星も）が加わります。出生時刻がないと紫微斗数のレイヤーは省かれ、省かれたレイヤーは課金されません。

リクエスト例

{
  "year": 1990, "month": 9, "day": 4, "hour": 14, "minute": 30,
  "timezone": "Asia/Seoul", "gender": "male",
  "topic": "career", "lang": "ko"
}

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

レスポンス例

{
  "success": true,
  "data": {
    "topics": [
      {
        "topic": "career",
        "paragraphs": [
          { "component": "ilju", "key": "임신", "text": "..." },
          { "component": "ilgan_wolji", "key": "임_신", "text": "..." },
          { "component": "ilgan_strength", "key": "임_신강", "text": "..." },
          { "component": "ilgan_yongshin", "key": "임_화", "text": "..." },
          { "component": "ohaeng_state", "key": "목_lack", "text": "..." },
          { "component": "ohaeng_state", "key": "토_lack", "text": "..." },
          { "component": "ohaeng_state", "key": "수_lack", "text": "..." },
          { "component": "top_sipsin", "key": "인성", "text": "..." }
        ]
      }
    ],
    "lang": "ko",
    "fallbackLanguage": null,
    "engine": { "version": 1, "styleVersion": "v1" }
  }
}

段落の本文（text）は省略しています。フィールドの説明の全体はリファレンスにあります。

料金

生涯四柱は、全テーマで1回 ₩100（VAT別、VAT込み ₩110）、1テーマで1回 ₩20（VAT別、VAT込み ₩22）です。西洋占星術と紫微斗数のレイヤーは、実際に段落を返したレイヤーごとに ₩20（VAT別、VAT込み ₩22）が加わります。成功した呼び出しだけがプリペイドのクレジットから差し引かれ、4xx・5xx のエラーレスポンスは課金されません。

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

料金一覧

リファレンス全体

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

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