Zi Wei Dou Shu: 星の配置

紫微斗數は、惑星ではなく、十二宮と百を超える星々を、月日と誕生時の刻限に基づいて配置して命盤を作成します。POST /v1/ziwei/chartはこれを完全に計算します。

エンドポイント

エンドポイント	クレジット	返されるもの
POST /v1/ziwei/chart	20	完全な命盤：宮、星、運限、四化。timeとgenderが必要です。
POST /v1/ziwei/four-transformations	10	年干による四化、四つの流派
POST /v1/ziwei/twelve-palaces	5	十二宮のリファレンス
POST /v1/ziwei/main-stars	5	十四主星のリファレンス
POST /v1/ziwei/palace-*	5	一つの宮のリファレンス、九つの経路

リファレンスルートはcomputed: falseフィールドを持ち、料金は半額です。これらはどの生年月日に対しても同じ表を返しますが、その旨が記載されている限り問題ありません。

`/ziwei/full-chart`は非推奨です

このエンドポイントは誰に対しても同じ宮の辞書を返しますが、その名前は命盤を返すことを示唆しています。2027-11-26まで変更なく応答し、Deprecation、Sunset、および後継へのLinkヘッダーを伴います。/v1/ziwei/chartに移行してください。これは生年月日と時刻に加えてgenderを必要とします。

例

curl -X POST https://api.astroway.info/v1/ziwei/chart \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2000-08-16","time":"04:00:00","gender":"male","age":25}'

{
  "fiveElementClass": { "key": "wood3", "chinese": "木三局", "name": "Wood 3", "value": 3 },
  "soulPalace": { "index": 4, "branch": "Wu" },
  "bodyPalace": { "index": 8, "branch": "Xu" },
  "ziwei": { "index": 4, "branch": "Wu" },
  "annualLimit": { "age": 25, "index": 8, "branch": "Xu" },
  "palaces": [
    {
      "branch": "Wu",
      "pillar": "Ren-Wu",
      "palace": "destiny",
      "isSoul": true,
      "majorStars": [{ "chinese": "紫微", "name": "Purple Star", "pinyin": "Zi Wei", "kind": "major" }],
      "lifeStage": { "chinese": "死", "name": "Death", "localised": "Death" },
      "boshi": "伏兵",
      "decade": { "index": 0, "fromAge": 3, "toAge": 12 }
    }
  ]
}

palaces配列は、寅から丑まで、すべての十二宮を同じ形式で保持しています。

計算される内容

ステップ	ルール
命宮と身宮	月の宮から、命宮は刻限を遡り、身宮は刻限を進む
宮の天干	年干からの五虎遁
五行局	命宮の柱から。六十干支のすべての組み合わせで納音と一致します。
紫微	日を局の数で割り、借用する：偶数の借用は進み、奇数の借用は戻る
紫微系 (6)	紫微から-1、-3、-4、-5、-8のオフセット
天府系 (8)	天府は寅-申軸を中心に紫微の鏡であり、さらに+1..+6、そして破軍には**+10**
六吉と六煞	月、刻限、年干から、それぞれ独自の計算式で
三十一の小星	年支、年干、月、日、刻限から
長生十二神	五行局から、陽男陰女は順行、それ以外は逆行
博士十二神	祿存から、同じ方向
將前と歲前 十二神	年支の三合から、および年支自体から、両方とも常に順行
大限	命宮から、局の数と同じ年齢で開始、十年ごとのステップ
小限	性別を読み取り、十年運とは異なり陰陽は読み取りません
四化	年干によるもの、星に直接表示されます

四つの流派切り替え

これらは私たちのコードではなくリクエストボディに含まれます。なぜなら、それぞれが影響を受ける誕生の命盤全体をシフトさせるからです。

パラメータ	デフォルト	第二の値
yearDivide	lunar: 年は旧暦の1月1日に始まります	lichun: BaZiからの境界
fixLeap	true: 閏月は15日で分割されます	false: 閏月全体が前の月として計算されます
dayDivide	forward: 23:00は翌日に属します	current: 日付はそのまま、刻限は晚子時としてマークされます
tianmaSchool	year: 天馬は年支から (中州派)	month: 天馬は旧暦の月から
school	zhongzhou: 王亭之の体系による四化	quanji、quanshu、beipai

誕生時刻は必須です

命宮は刻限から設定され、そこから五行局と各星が決まります。時刻のない命盤は部分的な応答ではなく、確実なナンセンスな十二宮となるため、timeのないリクエストは400エラーで拒否されます。これは、時刻がなければ時柱がないだけのBaZiとは異なります。

真太陽時

デフォルトでは、刻限はほとんどの実践者が読むように現地時間で読み取られます。trueSolarTime: trueをlongitudeとtimezoneOffsetと共に渡すと、刻限は誕生地の太陽に基づいて読み取られ、/v1/baziと同じ補正が適用されます。スペインやフランス西部では、この差は50分から135分に及び、刻限、ひいては命宮と各星が変わるのに十分です。この補正は刻限と日に適用されます。yearDivide=lichunの場合、立春の境界は時刻に基づいて維持されます。実際に適用された内容はinput.trueSolarTimeで返されます。trueSolarTimeなしのlongitudeは何も変更せず、longitudeまたはtimezoneOffsetなしのtrueSolarTimeは400 TRUE_SOLAR_TIME_NEEDS_PLACEを返します。

ここでは年は立春から始まりません

これは流派の選択ではありません。斗數は純粋に太陰暦のシステムであり、子平とは異なり、太陽暦の用語には移行しません。yearDivide=lichunは、BaZiから境界を借用した計算機との照合のためだけに存在します。

検証方法

これは意図的に、単一のライブラリではなく、公開されている3つの命盤に固定されています。Zi Weiのオープンなエコシステムのほぼすべては、1つのプロジェクトに由来しています。つまり、2つのポートと、別の系統を主張しながらも内部でそれを呼び出して出力を解析する少なくとも1つのプロジェクトです。したがって、複数のプロジェクトとの一致は、1つのプロジェクトとの一致に過ぎません。

• 2つの命盤が完全に再現されています：十四主星、五行局、命宮と身宮のすべて。
• 十二運限は、これら2つではなく、同じ情報源で期待される十二運限が公開されている3番目のフィクスチャベクトルで検証されています。大限の始まりは五行局の数、つまり導き出されるルールと照合されており、外部の出版物とは異なります。
• 3番目の命盤は、そのエコシステムとは無関係の中国の教育テキストから取得され、星のオフセットと宮の順序を独自に固定しています。
• 安紫微星の記憶術「六五四三二／酉午亥辰丑」と、火六局の1日から15日までの公開された運行は直接検証されています。これらは伝統の定数であり、誰かの実装ではありません。

あなたの計算機が異なる結果を出す場合

計算ではなく、4つの切り替え（年の境界、閏月、23:00の日の境界、および四化の表）を確認してください。ほとんどの場合、違いはそこにあります。

一般的な誤解

火星と鈴星は、検証されたどの伝承においても、年支の三合から順行で配置され、性別は読み取りません。これらに時々帰される陽男陰女順 / 陰男陽女逆の規則は、長生十二神の十二運限と十年運に属します。両方のテーマが最も頻繁にコピーされる情報源の同じページに記載されており、そこから混乱が生じたようです。

言語

宮と十二運限の名前は21言語に翻訳されています。?lang=を追加すると、各宮にpalaceLocalisedが、各運限にlocalisedフィールドが表示されます。星の名前は漢字のまま、隣に英語訳が併記されます。確立された名前がないためです。