Zi Wei Dou Shu: rozmístění hvězd

紫微斗數 vytváří mapu ne z planet, ale z dvanácti paláců a stovek hvězd s háčkem, rozmístěných podle pravidel od lunárního data a hodiny narození. POST /v1/ziwei/chart počítá to kompletně.

Endpointy

Endpoint	Kredity	Co vrací
POST /v1/ziwei/chart	20	Úplná mapa: paláce, hvězdy, fáze, hranice, 四化. Vyžaduje time a gender
POST /v1/ziwei/four-transformations	10	四化 podle roku, čtyři školy
POST /v1/ziwei/twelve-palaces	5	Průvodce dvanácti paláci
POST /v1/ziwei/main-stars	5	Průvodce čtrnácti hlavními hvězdami
POST /v1/ziwei/palace-*	5	Průvodce jedním palácem, devět cest

Referenční trasy nesou pole computed: false a stojí polovinu ceny. Vrací stejnou tabulku pro jakékoli datum narození, a na tom není nic špatného, pokud je to napsáno.

`/ziwei/full-chart` deprecated

Vrací stejný slovník paláců komukoli, a jeho název slibuje mapu. Odpovídá beze změn do 2027-11-26, nese hlavičky Deprecation, Sunset a Link na nástupce. Přepni na /v1/ziwei/chart: vyžaduje gender navíc k datu a hodině.

Příklad

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 }
    }
  ]
}

Pole palaces obsahuje všech dvanáct ve stejném formátu, od 寅 do 丑.

Co se přesně počítá

Krok	Pravidlo
命宮 a 身宮	Od paláce měsíce zpět podle hodin pro Život, vpřed pro Tělo
Stvoly paláců	五虎遁 od roku
五行局	Ze sloupu paláce Život; shoduje se s 納音 ve všech šedesáti párech
紫微	Rozdělení dne na číslo 局 s posunem: sudý posun vpřed, lichý zpět
紫微系 (6)	Posunutí −1, −3, −4, −5, −8 od 紫微
天府系 (8)	天府 je zrcadlo 紫微 kolem osy 寅-申, dále +1..+6 a +10 pro 破軍
六吉 a 六煞	Od měsíce, hodin a roku, každá se svou vlastní formulí
Тридцять jedna malá hvězda	Od větve roku, roku, měsíce, dne a hodin
長生十二神	Od 五行局, vpřed pro 陽男陰女 a zpět jinak
博士十二神	Od 祿存, stejný směr
将前 a 歲前 十二神	Od trojice větve roku a od samotné větve, oba vždy vpřed
大限	Od 命宮, start ve věku čísla 局, krok deset let
小限	Čte pohlaví a nečte jin-yang, na rozdíl od desetiletých
四化	Podle roku, označené přímo na hvězdách

Čtyři přepínače školy

Jsou v těle požadavku, ne v našem kódu, protože každý z nich posouvá mapu kompletně pro ty narození, na která se vztahuje.

Parametr	Výchozí hodnota	Druhá hodnota
yearDivide	lunar: rok začíná prvním dnem prvního lunárního měsíce	lichun: hranice z BaZi
fixLeap	true: přestupný měsíc se dělí patnáctým číslem	false: celý přestupný se počítá jako předchozí
dayDivide	forward: 23:00 patří následujícímu dni	current: datum zůstává, hodina se označuje jako 晚子時
tianmaSchool	year: 天馬 od větve roku (中州派)	month: 天馬 od lunárního měsíce
school	zhongzhou: 四化 podle korpusu 王亭之	quanji, quanshu, beipai

Narození hodina povinná

Palác Život se určuje od hodiny, a od ní závisí 五行局 a každá hvězda. Mapa bez hodiny by nebyla částečnou odpovědí, ale dvanácti paláci jisté nesmyslnosti, takže požadavek bez time je odmítnut s 400. To se liší od BaZi, kde bez hodiny prostě neexistuje hodinový sloupec.

Skutečný sluneční čas

Ve výchozím nastavení se hodina čte podle místního času, jak ji čte většina praktikujících. Předej trueSolarTime: true spolu s longitude a timezoneOffset, aby se hodina četla podle slunce nad místem narození, se stejnou úpravou jako v /v1/bazi. Ve Španělsku nebo na západě Francie rozdíl činí od 50 do 135 minut, a to stačí, aby se hodina změnila, a s ní Palác Život a každá hvězda. Úprava působí na hodinu i na den; při yearDivide=lichun hranice Lichun zůstává podle hodin. Co je konkrétně použito, vrací se v input.trueSolarTime. longitude bez trueSolarTime nic nemění, a trueSolarTime bez longitude či timezoneOffset dává 400 TRUE_SOLAR_TIME_NEEDS_PLACE.

Rok zde nezačíná Lichun

To není volba školy. 斗數 je čistě lunární systém a nepřechází na sluneční termíny, na rozdíl od 子平. yearDivide=lichun existuje jen pro srovnání s kalkulátorem, který přinesl hranici z BaZi.

Jak je to ověřeno

Připevněno ke třem publikovaným mapám, ne k jedné knihovně, a je to úmyslné. Téměř celá otevřená ekosystém Zi Wei pochází z jednoho projektu: dva porty plus alespoň jeden projekt, který tvrdí jinou linii, a uvnitř ho volá a rozebírá výstup. Proto shoda s několika projekty je shoda s jedním.

• Dvě mapy jsou plně reprodukovány: všechny čtrnáct hlavních hvězd, 五行局, paláce Život a Tělo.
• Dvanáct fází je ověřeno na třetím fixním vektoru stejného zdroje, kde jsou publikována očekávaná dvanáct, a ne na těchto dvou. Počátky desetiletí jsou srovnány s číslem 五行局, tedy s pravidlem, ze kterého jsou odvozeny, a ne s cizí publikací.
• Třetí mapa je převzata z čínského učebního textu bez vztahu k této ekosystému a samostatně připevňuje posuny hvězd a pořadí paláců.
• Mnemotechnika 安紫微星 “六五四三二／酉午亥辰丑” a publikovaný běh 火六局 po dnech 1‑15 jsou ověřeny přímo: jsou to konstanty tradice, ne cizí implementace.

Co dělat, když tvůj kalkulátor dává jiné

Kontroluj ne aritmetiku, ale čtyři přepínače: hranici roku, přestupný měsíc, hranici dne v 23:00 a tabulku 四化. Téměř vždy jsou tam rozdíly.

Jedna rozšířená verze, která je nesprávná

火星 a 鈴星 jsou rozmístěny vpřed od trojice větve roku a nečtou pohlaví v žádném ověřeném přenosu. Pravidlo 陽男陰女順 / 陰男陽女逆, které se k nim někdy připisuje, patří dvanácti fázím 長生十二神 a desetiletým hranicím. Obě témata jsou na jedné stránce v nejčastěji kopírovaném zdroji, a pravděpodobně odtud vznikla záměna.

Jazyky

Názvy paláců a dvanácti fází jsou přeloženy do 21 jazyků: přidej ?lang=, a v každém paláci se objeví palaceLocalised, a ve fázi pole localised. Názvy hvězd zůstávají hieroglyfy s anglickým překladem vedle: nemají ustálená jména.