AstroWay/api v2.260.0 · pl
wszystkie systemy w normie
// astrology api · POST /v1/ziwei/chart

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ą.

Endpoint
POST /v1/ziwei/chart
Koszt
20 kredytów
Opóźnienie
~130 ms
Poziom
Tier 2
// 01 / Co oblicza

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.

// 02 / Zapytanie na żywo

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
  }'
Odpowiedź (fragment)
{
  "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 / Parametry

Parametry

nametypeWymagane
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.
// 04 / Kiedy używać

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.

// 05 / Uwagi

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ę.

99.9% SLA · plany płatne · 30d status →