Zi Wei Dou Shu (Fialová hvězda) API
Datum narození, čas a pohlaví vytvoří celý diagram: dvanáct paláců s jejich kmeny, všech čtrnáct hlavních hvězd, pomocných, třicet jedna menších hvězd, dvanáct životních fází, dekádové limity a čtyři transformace označené na hvězdách, které je nesou.
Zi Wei Dou Shu (Fialová hvězda) API
Narození se převede na lunární datum, protože Zi Wei je čistě lunární systém a na rozdíl od BaZi nepřepíná na sluneční termíny. Z lunárního měsíce a dvojité hodiny endpoint umístí palác duše a těla, pak podle pravidla pěti tygřích přiřadí kmen každému paláci a načte pěti-elementovou třídu z pilíře paláce duše. Ta třída a lunární den umístí 紫微 podle klasického pravidla půjč-a-rozděl, šest hvězd její řady následuje pevnými posuny, 天府 ji odráží přes osu 寅-申 a nese svých osm. Na tento kostra navíc přibývají šest šťastných a šest neblahých hvězd, sklad platu a nebeský kůň, třicet jedna menší hvězda přiřazená různě k ročnímu kmenu, ročnímu větvi, měsíci, dni a hodině, dvanáct životních fází, cyklus učence, obecný cyklus a roční cyklus, desetileté limity otevírající se na čísle třídy a roční limit, pokud požaduješ věk. Čtyři transformace se odvodí z ročního kmene a připojí se přímo k hvězdám místo aby byly vráceny jako oddělený seznam.
POST/v1/ziwei/chart
curl -X POST https://api.astroway.info/v1/ziwei/chart \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "2000-08-16",
"time": "04:00:00",
"gender": "male",
"age": 25
}'{
"ok": true,
"data": {
"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" }],
"lifeStage": { "chinese": "死", "name": "Death" },
"decade": { "index": 0, "fromAge": 3, "toAge": 12 }
}
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. It is converted to a lunar date, because Zi Wei is a lunar system. |
| time | string (HH:MM:SS) | yes | Local clock time. Required: the soul palace is placed from the double-hour, so a chart without it would be twelve palaces of confident nonsense rather than a partial answer. |
| gender | string | yes | male or female. It sets the direction of the twelve life stages, the scholar cycle and the decade limits, so the chart cannot be built without it. |
| age | number | no | Return the annual-limit palace for this age. Omit and the field comes back null. |
| yearDivide | string | no | lunar (default: the year opens on day one of the first lunar month) or lichun (the BaZi boundary, for reconciling against a calculator that imported it). |
| fixLeap | boolean | no | Split a leap month at day 15 (default) or count the whole of it as the month it follows. |
| dayDivide | string | no | forward (default: 23:00 belongs to the next day) or current (keep the date and mark the hour as the late Zi). |
| school | string | no | The 四化 table: zhongzhou (default), quanji, quanshu or beipai. The four disagree on three of the ten year stems. |
| language | string | no | Any of 21 codes. Palace names and life-stage names come back translated; star names stay as characters with an English gloss. |
When to use it
Použij ho, když stavíš čínský astrologický produkt pro trh, který čte cokoliv jiného než čínštinu: aplikaci, čtenářskou službu, vykreslovač diagramů, agenta, který potřebuje strukturu před interpretací. Odpověď je čistě struktura bez textu, takže se snadno vloží do mřížky dvanácti paláců, generátoru reportů nebo LLM promptu. Referenční endpointy ve stejné rodině jsou levnější a užitečné pro glosáře a tooltipy, ale vrací stejnou tabulku pro každé narození a uvádějí to v poli, takže z nich nebuduj diagram.
Notes
Připnuto ke třem publikovaným diagramům místo jedné knihovny, úmyslně: téměř celý open-source ekosystém Zi Wei vychází z jediného projektu, takže souhlas s několika z nich je souhlas s jedním. Dva kompletní diagramy se přesně reprodukují a třetí pochází z nesouvisejícího učebního textu. Čtyři školní přepínače jsou v těle požadavku místo v našem kódu, protože každý posouvá celý diagram pro dotčená narození: roční hranice, přestupný měsíc, přechod v 23:00 a tabulka transformací. Když jiný kalkulátor nesouhlasí, zkontroluj ty ččetři před aritmetikou.
Try the Zi Wei Dou Shu API
Grab a key and make your first call in under a minute.