Zi Wei Dou Shu: disposizione delle stelle

紫微斗數 costruisce la carta non a partire dai pianeti, ma da dodici palazzi e da oltre un centinaio di stelle, disposte secondo regole che partono dalla data lunare e dalla veglia (doppia ora) di nascita. POST /v1/ziwei/chart calcola tutto questo per intero.

Endpoint

Endpoint	Crediti	Cosa restituisce
POST /v1/ziwei/chart	20	Carta completa: palazzi, stelle, stadi, limiti, 四化. Richiede time e gender
POST /v1/ziwei/four-transformations	10	四化 per il tronco dell’anno, quattro scuole
POST /v1/ziwei/twelve-palaces	5	Riferimento dei dodici palazzi
POST /v1/ziwei/main-stars	5	Riferimento delle quattordici stelle principali
POST /v1/ziwei/palace-*	5	Riferimento di un singolo palazzo, nove percorsi

Le rotte di riferimento portano il campo computed: false e costano metà tariffa. Restituiscono la stessa tabella per qualsiasi data di nascita, e non c’è nulla di male, finché è dichiarato.

`/ziwei/full-chart` è deprecato

Restituisce lo stesso dizionario dei palazzi a chiunque, mentre il suo nome promette una carta. Risponde senza modifiche fino al 2027-11-26 e porta gli header Deprecation, Sunset e Link verso il successore. Passa a /v1/ziwei/chart: richiede gender oltre a data e ora.

Esempio

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

L’array palaces contiene tutti e dodici nella stessa forma, da 寅 a 丑.

Cosa viene calcolato esattamente

Passo	Regola
命宮 e 身宮	Dal palazzo del mese, all’indietro per veglie per la Vita, in avanti per il Corpo
Tronchi dei palazzi	五虎遁 dal tronco dell’anno
五行局	Dal pilastro del palazzo della Vita; coincide con 納音 su tutte le sessanta coppie
紫微	Divisione del giorno per il numero del 局 con prestito: prestito pari in avanti, dispari all’indietro
紫微系 (6)	Spostamenti −1, −3, −4, −5, −8 da 紫微
天府系 (8)	天府 è lo specchio di 紫微 rispetto all’asse 寅-申, poi +1..+6 e +10 per 破軍
六吉 e 六煞	Da mese, veglia e tronco dell’anno, ciascuna con la propria formula
Trentuno stelle minori	Da ramo dell’anno, tronco dell’anno, mese, giorno e veglia
長生十二神	Da 五行局, in avanti per 陽男陰女 e all’indietro negli altri casi
博士十二神	Da 祿存, stessa direzione
將前 e 歲前 十二神	Dal trigono del ramo dell’anno e dal ramo stesso, entrambi sempre in avanti
大限	Da 命宮, inizio all’età pari al numero del 局, passo di dieci anni
小限	Legge il sesso e non legge lo yin-yang, a differenza dei limiti decennali
四化	Per il tronco dell’anno, segnate direttamente sulle stelle

Quattro selettori di scuola

Stanno nel body della richiesta e non nel nostro codice, perché ciascuno sposta l’intera carta per le nascite che tocca.

Parametro	Default	Secondo valore
yearDivide	lunar: l’anno inizia il primo giorno del primo mese lunare	lichun: confine preso dal BaZi
fixLeap	true: il mese intercalare si divide al quindicesimo giorno	false: tutto il mese intercalare conta come il precedente
dayDivide	forward: le 23:00 appartengono al giorno successivo	current: la data resta, la veglia è segnata come 晚子時
tianmaSchool	year: 天馬 dal ramo dell’anno (中州派)	month: 天馬 dal mese lunare
school	zhongzhou: 四化 secondo il corpus di 王亭之	quanji, quanshu, beipai

L'ora di nascita è obbligatoria

Il palazzo della Vita si pone a partire dalla veglia, e da esso dipendono 五行局 e ogni stella. Una carta senza ora non sarebbe una risposta parziale, ma dodici palazzi di sciocchezze presentate con sicurezza, per cui una richiesta senza time viene rifiutata con 400. È diverso dal BaZi, dove senza ora manca semplicemente il pilastro dell’ora.

Qui l'anno non inizia con Lichun

Non è una scelta di scuola. 斗數 è un sistema puramente lunare e non passa ai termini solari, a differenza di 子平. yearDivide=lichun esiste solo per il confronto con un calcolatore che ha preso in prestito il confine dal BaZi.

Come è stato verificato

Ancorato a tre carte pubblicate, non a una sola libreria, ed è voluto. Quasi tutto l’ecosistema open di Zi Wei deriva da un unico progetto: due port più almeno un progetto che dichiara un’altra linea ma internamente lo richiama e ne analizza l’output. Per questo la coincidenza con più progetti è la coincidenza con uno solo.

• Due carte sono riprodotte per intero: tutte e quattordici le stelle principali, 五行局, palazzi della Vita e del Corpo.
• I dodici stadi sono verificati sul terzo vettore di fixture della stessa fonte, dove sono pubblicati i dodici attesi, e non su queste due. Gli inizi dei decenni sono confrontati con il numero del 五行局, cioè con la regola da cui derivano, e non con una pubblicazione esterna.
• La terza carta è presa da un testo didattico cinese senza legami con quell’ecosistema e ancora in modo indipendente gli spostamenti delle stelle e l’ordine dei palazzi.
• La mnemonica 安紫微星 「六五四三二／酉午亥辰丑」 e la sequenza pubblicata di 火六局 per i giorni 1-15 sono verificate direttamente: sono costanti della tradizione, non l’implementazione di qualcuno.

Cosa fare quando il tuo calcolatore dà un risultato diverso

Non controllare l’aritmetica, ma i quattro selettori: confine dell’anno, mese intercalare, confine del giorno alle 23:00 e tabella dei 四化. Quasi sempre la divergenza è lì.

Una versione diffusa che è sbagliata

火星 e 鈴星 si dispongono in avanti dal trigono del ramo dell’anno e non leggono il sesso in nessuna trasmissione verificata. La regola 陽男陰女順 / 陰男陽女逆, che a volte viene loro attribuita, appartiene ai dodici stadi 長生十二神 e ai limiti decennali. Entrambi gli argomenti stanno sulla stessa pagina nella fonte più copiata, ed è probabilmente da lì che nasce la confusione.

Lingue

I nomi dei palazzi e dei dodici stadi sono tradotti in 21 lingue: aggiungi ?lang= e in ogni palazzo comparirà palaceLocalised, mentre nello stadio il campo localised. I nomi delle stelle restano in ideogrammi con la traduzione inglese accanto: non hanno nomi consolidati.