AstroWay/api v2.258.3 · it
tutti i sistemi sono operativi
// astrology api · POST /v1/ziwei/chart

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.

Endpoint
POST /v1/ziwei/chart
Cost
20 credits
Latency
~130 ms
Tier
Tier 2
// 01 / What it computes

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.

// 02 / Live request

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
  }'
Response (excerpt)
{
  "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 }
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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.
// 04 / When to use it

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.

// 05 / Notes

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.

99.9% SLA · piani a pagamento · 30d stato →