Zi Wei Dou Shu (Purple Star) API
Data urodzenia, godzina i płeć tworzą cały wykres: dwanaście pałaców z ich pniami, wszystkie czternaście głównych gwiazd, pomocnicze, trzydzieści jeden gwiazd pomocniczych, dwanaście etapów życia, granice dekady i cztery transformacje oznaczone na gwiazdach które je niosą.
Zi Wei Dou Shu (Purple Star) API
Urodzenie jest konwertowane na datę księżycową, bo Zi Wei to czysto księżycowy system i w przeciwieństwie do BaZi nie przełącza się na terminy słoneczne. Z miesiąca księżycowego i podwójnej godziny endpoint wyznacza pałac duszy i pałac ciała, potem stosuje regułę pięciu tygrysów do każdego pałacu, a następnie odczytuje klasę pięciu elementów z kolumny pałacu duszy. Ta klasa i dzień księżycowy umieszczają 紫微 według klasycznej reguły pożyczki i podziału, sześć gwiazd z jej serii podąża stałymi offsetami, 天府 odbija to wzdłuż osi 寅-申 i niesie własne osiem. Na tej szkieletowej podstawie dodane są sześć szczęśliwych i sześć niekorzystnych gwiazd, magazyn wynagrodzeń i niebiański koń, trzydzieści jeden gwiazd pomocniczych powiązanych różnie z pniem roku, gałęzią roku, miesiącem, dniem i godziną, dwanaście etapów życia, cykl uczonego, cykl generała i cykl roku, dziesięcioletnie granice otwierające się przy numerze klasy oraz roczna granica, jeśli zapytasz o wiek. Cztery transformacje są wyznaczane z pnia roku i przyłączane do samych gwiazd, a nie zwracane jako oddzielna lista.
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 }
}
]
}
} Parametry
| name | type | Wymagane | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | tak | Birth date. It is converted to a lunar date, because Zi Wei is a lunar system. |
| time | string (HH:MM:SS) | tak | 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 | tak | 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 | nie | Return the annual-limit palace for this age. Omit and the field comes back null. |
| yearDivide | string | nie | 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 | nie | Split a leap month at day 15 (default) or count the whole of it as the month it follows. |
| dayDivide | string | nie | forward (default: 23:00 belongs to the next day) or current (keep the date and mark the hour as the late Zi). |
| school | string | nie | The 四化 table: zhongzhou (default), quanji, quanshu or beipai. The four disagree on three of the ten year stems. |
| language | string | nie | Any of 21 codes. Palace names and life-stage names come back translated; star names stay as characters with an English gloss. |
Kiedy używać
Użyj go, kiedy tworzysz produkt chińskiej astrologii dla rynku, który nie czyta chińskiego: aplikację, usługę odczytu, renderowanie wykresu, agenta, który potrzebuje struktury przed interpretacją. Odpowiedź to czysta struktura bez prozy, więc łatwo wpasuje się w siatkę dwunastu pałaców, generator raportów albo prompt LLM. Referencyjne endpointy w tej samej rodzinie są tańsze i przydatne do słowników i podpowiedzi, ale zwracają tę samą tabelę dla każdego urodzenia i podają to w polu, więc nie buduj z nich wykresu.
Uwagi
Zamocowano do trzech opublikowanych wykresów, a nie jednej biblioteki, celowo: prawie cały otwarto-źródłowy ekosystem Zi Wei wywodzi się z jednego projektu, więc zgadzając się z kilkoma, zgadzasz się z jednym. Dwa pełne wykresy odtwarzają się dokładnie, a trzeci pochodzi z niepowiązanego tekstu nauczającego. Cztery przełączniki szkół znajdują się w ciele żądania, nie w kodzie, bo każdy przemieszcza cały wykres dla dotkniętych urodzeń: granica roku, miesiąc przestępny, przeskok o 23:00 i tabela transformacji. Gdy inny kalkulator się nie zgadza, sprawdź te cztery przed arytmetyką.
Wypróbuj API Zi Wei Dou Shu
Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.