四柱推命API › 紫微斗数API

紫微斗数API

生年月日時を送ると、紫微斗数の命盤をJSONで受け取れます。十二宮、十四主星と副星（輝度と生年四化付き）、五行局、命宮と身宮の位置、基準日の大限と流年です。紫微斗数は、人生の各分野を表す十二宮に星を配置する中国の占星術です。商品名は「紫微斗数命盤」です。同じ入力ならいつも同じ結果になります。

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

返すもの

解釈の段落を加える

readings: true を送ると、命宮の主星の組み合わせ、7つのテーマ、財帛宮・官禄宮・夫妻宮・疾厄宮の主星についての解釈の段落が加わります。追加料金がかかり、金額は リファレンスにあります。

出生時刻がない場合

紫微斗数の命盤は出生時刻なしでは作れないため、 hour を省略すると400 birth_time_required を返します。エラーレスポンスなので、何も差し引かれません。

リクエスト例

{
  "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30,
  "gender": "female", "referenceDate": "2026-10-08", "lang": "ko"
}

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

レスポンス例（抜粋）

{
  "success": true,
  "data": {
    "engineVersion": 1,
    "lang": "ko",
    "referenceDate": "2026-10-08",
    "clock": {
      "inputSolarDate": "1990-05-15", "inputTime": "14:30",
      "correctedSolarDate": "1990-05-15", "correctedTime": "14:30",
      "correctionMinutes": 0, "dstApplied": false, "basis": null,
      "hourBranch": { "key": "wei", "label": "미" }
    },
    "chart": {
      "engine": { "name": "iztro", "version": "2.6.1", "config": { ... } },
      "solarDate": "1990-05-15",
      "lunarDate": { "year": 1990, "month": 4, "day": 21, "isLeapMonth": false },
      "yearGanzhi": "경오",
      "yearBasisNote": null,
      "fiveElementsClass": { "key": "earth5", "label": "토오국" },
      "soulPalaceBranch": { "key": "xu", "label": "술" },
      "bodyPalaceBranch": { "key": "zi", "label": "자" },
      …

上のリクエストに対するレスポンスの冒頭です。十二宮・四化・ルールキーを含むレスポンスとフィールドの説明は リファレンスにあります。

料金

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

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

料金一覧

リファレンス全体

パラメータ表の全体、レスポンスフィールドの説明、エラーコードはリファレンスにあります: 紫微斗数命盤API リファレンス。ほかの四柱推命（サジュ）商品は 四柱推命APIすべてにあります。

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