Zi Wei Dou Shu: disposizione delle stelle

紫微斗數 costruisce una carta non dai pianeti, ma da dodici palazzi e oltre cento stelle, disposte secondo regole basate sulla data lunare e sull’ora di nascita. POST /v1/ziwei/chart calcola tutto questo completamente.

Endpoint

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

I percorsi di riferimento contengono il campo computed: false e costano metà della tariffa. Restituiscono la stessa tabella per qualsiasi data di nascita, e non c’è nulla di male in questo, purché sia specificato.

`/ziwei/full-chart` è deprecato

Restituisce lo stesso dizionario di palazzi a chiunque, mentre il suo nome promette una carta. Risponde senza modifiche fino al 2027-11-26, include gli header Deprecation, Sunset e Link al successore. Passa a /v1/ziwei/chart: richiede gender in aggiunta 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 nello stesso formato, da 寅 a 丑.

Cosa viene calcolato esattamente

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

Quattro interruttori di scuola

Si trovano nel corpo della richiesta, non nel nostro codice, perché ognuno di essi sposta completamente la carta per le nascite che influenza.

Parametro	Predefinito	Secondo valore
yearDivide	lunar: l’anno inizia il primo giorno del primo mese lunare	lichun: confine da BaZi
fixLeap	true: il mese bisestile è diviso dal quindicesimo giorno	false: l’intero mese bisestile è contato come il precedente
dayDivide	forward: le 23:00 appartengono al giorno successivo	current: la data rimane, l’ora di nascita è indicata come 晚子時
tianmaSchool	year: 天馬 dal ramo annuale (中州派)	month: 天馬 dal mese lunare
school	zhongzhou: 四化 secondo il corpus di 王亭之	quanji, quanshu, beipai

L'ora di nascita è obbligatoria

Il Palazzo della Vita è determinato dall’ora di nascita, e da esso dipendono 五行局 e ogni stella. Una carta senza ora non sarebbe una risposta parziale, ma dodici palazzi di sicura assurdità, quindi una richiesta senza time viene rifiutata con 400. Questo è diverso da BaZi, dove senza ora semplicemente non c’è il pilastro orario.

Ora solare vera

Per impostazione predefinita, l’ora di nascita viene letta dall’orologio locale, come la maggior parte dei praticanti. Passa trueSolarTime: true insieme a longitude e timezoneOffset affinché l’ora di nascita sia letta in base al sole sopra il luogo di nascita, con la stessa correzione di /v1/bazi. In Spagna o nella Francia occidentale, la differenza è tra 50 e 135 minuti, e questo è sufficiente per cambiare l’ora di nascita, e con essa il Palazzo della Vita e ogni stella. La correzione si applica all’ora di nascita e al giorno; con yearDivide=lichun il confine Lichun rimane basato sull’orologio. Ciò che è stato applicato viene restituito in input.trueSolarTime. longitude senza trueSolarTime non cambia nulla, mentre trueSolarTime senza longitude o timezoneOffset restituisce 400 TRUE_SOLAR_TIME_NEEDS_PLACE.

L'anno qui non inizia con Lichun

Questa non è una scelta di scuola. 斗數 è un sistema puramente lunare e non passa ai termini solari, a differenza di 子平. yearDivide=lichun esiste solo per la verifica con un calcolatore che ha importato il confine da BaZi.

Come è stato verificato

È stato ancorato a tre carte pubblicate, non a una singola libreria, e questo è intenzionale. Quasi tutto l’ecosistema open source di Zi Wei deriva da un unico progetto: due porting più almeno un progetto che dichiara una linea diversa, ma al suo interno lo richiama e ne analizza l’output. Pertanto, la corrispondenza con più progetti è una corrispondenza con uno solo.

• Due carte sono state riprodotte completamente: tutte le quattordici stelle principali, 五行局, i palazzi della Vita e del Corpo.
• Le dodici fasi sono state verificate su un terzo vettore di fixture della stessa fonte dove sono pubblicate le dodici attese, e non su queste due. Gli inizi dei decenni sono stati confrontati con il numero di 五行局, cioè con la regola da cui sono derivati, e non con una pubblicazione esterna.
• Una terza carta è stata presa da un testo didattico cinese senza relazione con quell’ecosistema e fissa autonomamente lo spostamento delle stelle e l’ordine dei palazzi.
• La mnemonica 安紫微星 「六五四三二／酉午亥辰丑」 e il percorso pubblicato di 火六局 per i giorni 1-15 sono verificati direttamente: queste 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 interruttori: il confine dell’anno, il mese bisestile, il confine del giorno alle 23:00 e la tabella 四化. Quasi sempre la discrepanza è lì.

Un’interpretazione comune che è errata

火星 e 鈴星 sono posizionati in avanti dalla triade del ramo annuale e non leggono il sesso in nessuna trasmissione verificata. La regola 陽男陰女順 / 陰男陽女逆, che a volte viene loro attribuita, appartiene alle dodici fasi 長生十二神 e ai limiti decennali. Entrambi gli argomenti si trovano sulla stessa pagina nella fonte più frequentemente copiata, e sembra che la confusione sia nata da lì.

Lingue

I nomi dei palazzi e delle dodici fasi sono tradotti in 21 lingue: aggiungi ?lang=, e in ogni palazzo apparirà palaceLocalised, e nella fase il campo localised. I nomi delle stelle rimangono ideogrammi con una traduzione inglese accanto: non hanno nomi stabiliti.