Zi Wei Dou Shu: de plaatsing van de sterren

Zi Wei Dou Shu bouwt een horoscoop niet op basis van planeten, maar van twaalf paleizen en meer dan honderd sterren, gerangschikt volgens regels afgeleid van de maanstand en het geboorte-uur. POST /v1/ziwei/chart berekent dit volledig.

Endpoints

Endpoint	Kredieten	Retourneert
POST /v1/ziwei/chart	20	Volledige horoscoop: paleizen, sterren, fasen, grenzen, 四化. Vereist time en gender
POST /v1/ziwei/four-transformations	10	四化 per jaarstam, vier scholen
POST /v1/ziwei/twelve-palaces	5	Referentie voor de twaalf paleizen
POST /v1/ziwei/main-stars	5	Referentie voor de veertien hoofdsterren
POST /v1/ziwei/palace-*	5	Referentie voor één paleis, negen paden

Referentie-routes bevatten het veld computed: false en kosten de helft van het tarief. Ze retourneren dezelfde tabel voor elke geboortedatum, en dat is prima, zolang het maar vermeld wordt.

`/ziwei/full-chart` is verouderd

Deze retourneert voor iedereen hetzelfde woordenboek van paleizen, terwijl de naam een horoscoop belooft. Reageert ongewijzigd tot 2027-11-26, bevat de headers Deprecation, Sunset en Link naar de opvolger. Stap over op /v1/ziwei/chart: deze vereist gender naast de datum en tijd.

Voorbeeld

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

De palaces-array bevat alle twaalf in dezelfde vorm, van 寅 tot 丑.

Wat precies wordt berekend

Stap	Regel
命宮 en 身宮	Vanaf het paleis van de maand terug door de uren voor Leven, vooruit voor Lichaam
Stammen van de paleizen	五虎遁 vanaf de jaarstam
五行局	Vanaf de pilaar van het Levenspaleis; komt overeen met 納音 voor alle zestig paren
紫微	Deling van de dag door het getal 局 met lening: even lening vooruit, oneven achteruit
紫微系 (6)	Verschuiving −1, −3, −4, −5, −8 vanaf 紫微
天府系 (8)	天府 is de spiegel van 紫微 rond de 寅-申 as, verder +1..+6 en +10 voor 破軍
六吉 en 六煞	Vanaf de maand, het uur en de jaarstam, elk met zijn eigen formule
Eenendertig kleine sterren	Vanaf de jaartak, jaarstam, maand, dag en het uur
長生十二神	Vanaf 五行局, vooruit voor 陽男陰女 en andersom
博士十二神	Vanaf 祿存, dezelfde richting
將前 en 歲前 十二神	Vanaf de drievoudige jaartak en vanaf de tak zelf, beide altijd vooruit
大限	Vanaf 命宮, start op de leeftijd van het getal 局, stap van tien jaar
小限	Leest geslacht en leest geen yin-yang, in tegenstelling tot de tienjarige
四化	Per jaarstam, direct op de sterren aangegeven

Vier schoolschakelaars

Ze bevinden zich in de request body, niet in onze code, omdat elk van hen de horoscoop volledig verschuift voor de geboorten die het beïnvloedt.

Parameter	Standaard	Tweede waarde
yearDivide	lunar: jaar begint op de eerste dag van de eerste maanmaand	lichun: grens van BaZi
fixLeap	true: schrikkelmaand wordt gedeeld door de vijftiende dag	false: de hele schrikkelmaand wordt als de vorige geteld
dayDivide	forward: 23:00 behoort tot de volgende dag	current: datum blijft, uur wordt aangeduid als 晚子時
tianmaSchool	year: 天馬 vanaf de jaartak (中州派)	month: 天馬 vanaf de maanmaand
school	zhongzhou: 四化 volgens het corpus van 王亭之	quanji, quanshu, beipai

Geboorte-uur is verplicht

Het Levenspaleis wordt bepaald door het uur, en daarvan hangen de 五行局 en elke ster af. Een horoscoop zonder uur zou geen gedeeltelijk antwoord zijn, maar twaalf paleizen van zekere onzin, daarom wordt een verzoek zonder time afgewezen met 400. Dit verschilt van BaZi, waar zonder uur simpelweg geen uurpilaar is.

Ware zonnetijd

Standaard wordt het uur gelezen volgens de lokale tijd, zoals de meeste beoefenaars het lezen. Geef trueSolarTime: true mee samen met longitude en timezoneOffset, zodat het uur wordt gelezen volgens de zon boven de geboorteplaats, met dezelfde correctie als in /v1/bazi. In Spanje of West-Frankrijk bedraagt het verschil 50 tot 135 minuten, en dat is voldoende om het uur te veranderen, en daarmee het Levenspaleis en elke ster. De correctie is van toepassing op het uur en de dag; bij yearDivide=lichun blijft de Lichun-grens volgens de klok. Wat precies is toegepast, wordt geretourneerd in input.trueSolarTime. longitude zonder trueSolarTime verandert niets, en trueSolarTime zonder longitude of timezoneOffset resulteert in 400 TRUE_SOLAR_TIME_NEEDS_PLACE.

Het jaar begint hier niet met Lichun

Dit is geen schoolkeuze. 斗數 is een puur maansysteem en schakelt niet over op zonnetermen, in tegenstelling tot 子平. yearDivide=lichun bestaat alleen voor verificatie met een calculator die de grens van BaZi heeft overgenomen.

Hoe dit is geverifieerd

Vastgepind aan drie gepubliceerde horoscopen, niet aan één bibliotheek, en dit is opzettelijk. Bijna het hele open Zi Wei-ecosysteem komt voort uit één project: twee poorten plus minstens één project dat een andere lijn claimt, maar intern het eerste aanroept en de output parseert. Daarom is overeenkomst met meerdere projecten een overeenkomst met één.

• Twee horoscopen zijn volledig gereproduceerd: alle veertien hoofdsterren, 五行局, de paleizen van Leven en Lichaam.
• De twaalf fasen zijn geverifieerd aan de hand van een derde fixture-vector uit dezelfde bron waar de verwachte twaalf zijn gepubliceerd, en niet aan de hand van deze twee. De beginjaren van de decennia zijn vergeleken met het getal 五行局, dat wil zeggen met de regel waaruit ze zijn afgeleid, en niet met een externe publicatie.
• De derde horoscoop is afkomstig uit een Chinese onderwijstekst zonder verband met dat ecosysteem en verankert de verschuiving van sterren en de volgorde van paleizen onafhankelijk.
• De ezelsbrug 安紫微星 「六五四三二／酉午亥辰丑」 en de gepubliceerde reeks van 火六局 voor dagen 1-15 worden direct geverifieerd: dit zijn constanten van de traditie, niet iemands implementatie.

Wat te doen als je calculator iets anders aangeeft

Controleer niet de rekenkunde, maar de vier schakelaars: de jaargrens, de schrikkelmaand, de daggrens om 23:00 uur en de 四化-tabel. Bijna altijd liggen de verschillen daar.

Eén veelvoorkomende, incorrecte overlevering

火星 en 鈴星 worden vooruit geplaatst vanaf de drievoudige jaartak en lezen geen geslacht in geen enkele geverifieerde overlevering. De regel 陽男陰女順 / 陰男陽女逆, die soms aan hen wordt toegeschreven, behoort tot de twaalf fasen 長生十二神 en de tienjarige grenzen. Beide onderwerpen staan op dezelfde pagina in de meest gekopieerde bron, en het lijkt erop dat de verwarring daar vandaan komt.

Talen

De namen van de paleizen en de twaalf fasen zijn vertaald naar 21 talen: voeg ?lang= toe, en in elk paleis verschijnt palaceLocalised, en in de fase het veld localised. De namen van de sterren blijven ideogrammen met een Engelse vertaling ernaast: ze hebben geen vaste namen.