Zi Wei Dou Shu (Steaua Violetă) API
O dată de naștere, o oră și un sex produc întreaga diagramă: douăsprezece palate cu tulpinile lor, toate cei paisprezece stele principale, auxiliare, treizeci și una de stele minore, cele douăsprezece etape ale vieții, limitele decadelor și cele patru transformări marcate pe stelele care le poartă.
Zi Wei Dou Shu (Steaua Violetă) API
Nașterea e convertită la o dată lunară, pentru că Zi Wei e un sistem pur lunar și, spre deosebire de BaZi, nu trece la termenele solare. Din luna lunară și dublu-oră endpoint-ul plasează palatul sufletului și palatul corpului, apoi aplică regula celor cinci tigri pe fiecare palat, apoi citește clasa celor cinci elemente din stâlpul palatului sufletului. Acea clasă și ziua lunară plasează 紫微 conform regulii clasice de împrumut-și-împărțire, cele șase stele ale seriei sale urmează cu offseturi fixe, 天府 o reflectă pe axa 寅-申 și poartă propriile opt. Pe deasupra acestui schelet vin cele șase stele norocoase și cele șase malefice, depozitul salariului și calul ceresc, treizeci-una de stele minore legate de tulpina anului, ramura anului, luna, ziua și ora, cele douăsprezece etape ale vieții, ciclul savantului, ciclul general și ciclul anului, limitele de zece ani care se deschid la numărul clasei și limita anuală dacă ceri vârsta. Cele patru transformări se rezolvă din tulpina anului și se atașează stelelor în sine, nu se întorc ca o listă separată.
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
Folosește-l când construiești un produs de astrologie chineză pentru o piață care citește altceva decât chineză: o aplicație, un serviciu de citiri, un renderer de diagrame, un agent care are nevoie de structură înainte să interpreteze. Răspunsul e doar structură, fără proză, așa că se potrivește într-o grilă de doisprezece palate, un generator de rapoarte sau un prompt LLM la fel de bine. Endpoint-urile de referință din aceeași familie sunt mai ieftine și utile pentru glosare și tooltipuri, dar returnează același tabel pentru fiecare naștere și îl indică într-un câmp, așa că nu construi o diagramă din ele.
Notes
Fixat pe trei diagrame publicate în loc de o singură bibliotecă, deliberat: aproape tot ecosistemul open-source Zi Wei provine dintr-un singur proiect, așa că a fi de acord cu mai multe înseamnă a fi de acord cu unul. Două diagrame complete se reproduc exact, iar a treia vine dintr-un text de învățătură nelegat. Patru comutatoare de școală trăiesc în corpul cererii, nu în codul nostru, pentru că fiecare mută întreaga diagramă pentru nașterile pe care le atinge: limita anului, luna bisectă, trecerea de la 23:00 și tabelul de transformări. Când alt calculator nu e de acord, verifică acele patru înainte de aritmetică.
Try the Zi Wei Dou Shu API
Grab a key and make your first call in under a minute.