Zi Wei Dou Shu (Stella Viola) API
Una data di nascita, un'ora e un sesso producono l'intero grafico: dodici palazzi con i loro tronchi, tutte le quattordici stelle principali, le ausiliarie, trentuno stelle minori, i dodici stadi della vita, i limiti decennali e le quattro trasformazioni segnate sulle stelle che le portano.
Zi Wei Dou Shu (Stella Viola) API
La nascita viene convertita in una data lunare, perché Zi Wei è un sistema puramente lunare e, a differenza di BaZi, non passa ai termini solari. Dal mese lunare e dall'ora doppia, l'endpoint colloca il palazzo dell'anima e il palazzo del corpo, poi tronca ogni palazzo con la regola delle cinque tigri, poi legge la classe dei cinque elementi dal pilastro del palazzo dell'anima. Quella classe e il giorno lunare collocano 紫微 con la regola classica del prestito e della divisione, le sei stelle della sua serie seguono con offset fissi, 天府 la specchia sull'asse 寅-申 e porta le sue otto. Su quel scheletro vanno le sei stelle fortunate e le sei stelle malefiche, il magazzino dello stipendio e il cavallo celeste, trentuno stelle minori collegate in vari modi al tronco dell'anno, al ramo dell'anno, al mese, al giorno e all'ora, i dodici stadi della vita, il ciclo dello studioso, il ciclo generale e il ciclo annuale, i limiti decennali che iniziano al numero di classe, e il limite annuale se chiedi un'età. Le quattro trasformazioni si risolvono dal tronco dell'anno e si allegano alle stesse stelle anziché essere restituite come elenco separato.
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
Ricorri ad esso quando stai costruendo un prodotto di astrologia cinese per un mercato che legge qualsiasi cosa diverso dal cinese: un'app, un servizio di lettura, un renderer di grafici, un agente che ha bisogno della struttura prima di interpretarla. La risposta è pura struttura senza prosa, quindi si adatta bene a una griglia di dodici palazzi, un generatore di report o un prompt LLM. Gli endpoint di riferimento nella stessa famiglia sono più economici e utili per glossari e tooltip, ma restituiscono la stessa tabella per ogni nascita e lo dicono in un campo, quindi non costruire un grafico con loro.
Notes
Ancorato a tre grafici pubblicati piuttosto che a una singola libreria, deliberatamente: quasi l'intero ecosistema open-source Zi Wei discende da un singolo progetto, quindi essere d'accordo con alcuni di essi significa essere d'accordo con uno. Due grafici completi si riproducono esattamente, e un terzo proviene da un testo di insegnamento non correlato. Quattro cambiamenti di scuola vivono nel corpo della richiesta anziché nel nostro codice, perché ciascuno sposta l'intero grafico per le nascite che tocca: il confine dell'anno, il mese bisestile, il passaggio alle 23:00 e la tabella delle trasformazioni. Quando un altro calcolatore non è d'accordo, controlla quei quattro prima dell'aritmetica.
Try the Zi Wei Dou Shu API
Grab a key and make your first call in under a minute.