Zi Wei Dou Shu (Paarse Ster) API
Een geboortedatum, een tijd en een geslacht produceren de volledige kaart: twaalf paleizen met hun stammen, alle veertien hoofdsterren, de hulpsterren, eenendertig kleine sterren, de twaalf levensfasen, de decenniumgrenzen en de vier transformaties gemarkeerd op de sterren die ze dragen.
Zi Wei Dou Shu (Paarse Ster) API
De geboorte wordt omgezet naar een maankalender datum, omdat Zi Wei een puur maansysteem is en, in tegenstelling tot BaZi, niet overschakelt naar de zonne-termen. Vanuit de maankalender maand en het dubbele uur plaatst de endpoint het zielspaleis en het lichaamspaleis, daarna stemt elk paleis volgens de vijf-tijgers regel, vervolgens leest het de vijf-elementen klasse van de zielspaleis pilaar. Die klasse en de maankalender dag plaatsen 紫微 volgens de klassieke leen-en-deel regel, de zes sterren van zijn serie volgen met vaste offsets, 天府 spiegelt het over de 寅-申 as en draagt zijn eigen acht. Bovenop dat skelet komen de zes geluks- en zes kwaadaardige sterren, de salarisschat en het hemelse paard, eenendertig kleine sterren gekoppeld aan de jaartak, de jaarvertakking, de maand, de dag en het uur, de twaalf levensfasen, de geleerde cyclus, de generaal cyclus en de jaar cyclus, de tienjarenlimieten die beginnen bij het klassennummer, en de jaarlijkse limiet als je een leeftijd vraagt. De vier transformaties worden afgeleid van de jaartak en aan de sterren zelf gehecht in plaats van als een losse lijst terug te geven.
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
Gebruik het wanneer je een Chinees-astrologie product bouwt voor een markt die iets anders dan Chinees leest: een app, een leesservice, een kaartrenderer, een agent die de structuur nodig heeft voordat hij interpreteert. Het antwoord is pure structuur zonder proza, dus het past in een twaalf-paleis raster, een rapportgenerator of een LLM prompt net zo goed. De referentie-endpoints in dezelfde familie zijn goedkoper en handig voor glossaria en tooltips, maar ze geven dezelfde tabel voor elke geboorte terug en vermelden dat in een veld, dus bouw er geen kaart van.
Notes
Vastgezet op drie gepubliceerde kaarten in plaats van op één bibliotheek, bewust: bijna het hele open-source Zi Wei ecosysteem komt van één project, dus akkoord gaan met meerdere betekent akkoord gaan met één. Twee volledige kaarten reproduceren exact, en een derde komt uit een niet-gerelateerd leermateriaal. Vier school-schakelaars staan in de request-body in plaats van in onze code, omdat elk de hele kaart verschuift voor de geboorten die ze raken: de jaargrens, de schrikkelmaand, de 23:00 omslag en de transformatietabel. Als een andere rekenmachine het niet eens is, controleer die vier eerst vóór de rekenkunst.
Try the Zi Wei Dou Shu API
Grab a key and make your first call in under a minute.