Zi Wei Dou Shu (Purple Star) API
Une date de naissance, une heure et un sexe génèrent le tableau complet : douze palais avec leurs tiges, les quatorze étoiles principales, les auxiliaires, trente-une étoiles mineures, les douze étapes de vie, les limites décennales et les quatre transformations marquées sur les étoiles qui les portent.
Zi Wei Dou Shu (Purple Star) API
La naissance est convertie en date lunaire, car Zi Wei est un système purement lunaire et, contrairement à BaZi, ne passe pas aux termes solaires. À partir du mois lunaire et de la double-heure, l'endpoint place le palais de l'âme et le palais du corps, puis applique la règle des cinq-tigres à chaque palais, puis lit la classe des cinq-éléments du pilier du palais de l'âme. Cette classe et le jour lunaire placent 紫微 selon la règle classique d'emprunt-et-division, les six étoiles de sa série suivent avec des décalages fixes, 天府 les reflète sur l'axe 寅-申 et porte ses propres huit. Au-dessus de ce squelette se superposent les six étoiles chanceuses et les six étoiles maléfiques, le magasin de salaire et le cheval céleste, trente-une étoiles mineures liées au tronc de l'année, à la branche de l'année, au mois, au jour et à l'heure, les douze étapes de vie, le cycle du savant, le cycle général et le cycle de l'année, les limites décennales ouvrant au class number, et la annual limit si tu demandes un age. Les four transformations sont résolues à partir du tronc de l'année et attachées aux étoiles elles-mêmes plutôt que retournées comme une liste détachée.
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
Utilise-le quand tu construis un produit d'astrologie chinoise pour un marché qui lit autre chose que le chinois : une app, un service de lecture, un rendu de tableau, un agent qui a besoin de la structure avant d'interpréter. La réponse est une structure pure sans prose, donc elle s'intègre dans une grille à douze palais, un générateur de rapport ou un prompt LLM aussi bien. Les reference endpoints de la même famille sont moins chers et utiles pour les glossaires et les tooltips, mais ils renvoient la même table pour chaque naissance et l'indiquent dans un champ, donc ne construis pas de tableau à partir d'eux.
Notes
Épinglé à trois tableaux publiés plutôt qu'à une bibliothèque, délibérément : presque tout l'écosystème open-source Zi Wei descend d'un seul projet, donc être d'accord avec plusieurs d'entre eux, c'est être d'accord avec un seul. Deux tableaux complets reproduisent exactement, et un troisième provient d'un texte d'enseignement indépendant. Quatre commutateurs d'école résident dans le request body plutôt que dans notre code, car chacun déplace le tableau complet pour les naissances qu'il touche : la limite d'année, le mois intercalaire, le basculement à 23 h00 et la table de transformation. Quand un autre calculateur n'est pas d'accord, vérifie ces quatre avant l'arithmétique.
Try the Zi Wei Dou Shu API
Grab a key and make your first call in under a minute.