AstroWay/api v2.260.0 · de
alle Systeme in Ordnung
// astrology api · POST /v1/ziwei/chart

Zi Wei Dou Shu (Purple Star) API

Ein Geburtsdatum, eine Uhrzeit und ein Geschlecht erzeugen das komplette Diagramm: zwölf Paläste mit ihren Stämmen, alle vierzehn Hauptsterne, die Hilfssterne, einunddreißig Nebensterne, die zwölf Lebensphasen, die Jahrzehntgrenzen und die vier Transformationen, die auf den Sternen markiert sind, die sie tragen.

Endpunkt
POST /v1/ziwei/chart
Kosten
20 Credits
Latenz
~130 ms
Stufe
Tier 2
// 01 / Was es berechnet

Zi Wei Dou Shu (Purple Star) API

Die Geburt wird in ein Monddatum umgewandelt, weil Zi Wei ein rein lunarer Kalender ist und, im Gegensatz zu BaZi, nicht zu den Sonnenbegriffen wechselt. Aus dem Mondmonat und der doppelten Stunde bestimmt der Endpoint den Seelenpalast und den Körperpalast, dann ordnet er jedem Palast nach der Fünf-Tiger-Regel Stämme zu und liest die Fünf-Element-Klasse aus dem Säulen-Seelenpalast. Diese Klasse und der Mondtag platzieren 紫微 nach der klassischen Ausleih-und-Teil-Regel, die sechs Sterne seiner Serie folgen mit festen Offsets, 天府 spiegelt ihn über die 寅-申-Achse und trägt seine eigenen acht. Auf diesem Skelett liegen die sechs Glücks- und sechs Unglücksst Sterne, das Gehalts-Depot und das Himmels-Pferd, einunddreißig Nebensterne, die verschieden dem Jahresstamm, dem Jahreszweig, dem Monat, dem Tag und der Stunde zugeordnet sind, die zwölf Lebensphasen, der Gelehrten-Zyklus, der General-Zyklus und der Jahres-Zyklus, die Zehn-Jahres-Grenzen, die bei der Klassennummer beginnen, und die Jahres-Grenze, wenn du nach einem Alter fragst. Die vier Transformationen werden aus dem Jahresstamm abgeleitet und den Sternen selbst zugeordnet, statt als separate Liste zurückzugeben.

// 02 / Live-Anfrage

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
  }'
Antwort (Auszug)
{
  "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 / Parameter

Parameter

nametypeErforderlich
date string (YYYY-MM-DD) ja Birth date. It is converted to a lunar date, because Zi Wei is a lunar system.
time string (HH:MM:SS) ja 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 ja 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 nein Return the annual-limit palace for this age. Omit and the field comes back null.
yearDivide string nein 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 nein Split a leap month at day 15 (default) or count the whole of it as the month it follows.
dayDivide string nein forward (default: 23:00 belongs to the next day) or current (keep the date and mark the hour as the late Zi).
school string nein The 四化 table: zhongzhou (default), quanji, quanshu or beipai. The four disagree on three of the ten year stems.
language string nein Any of 21 codes. Palace names and life-stage names come back translated; star names stay as characters with an English gloss.
// 04 / Wann verwenden

Wann verwenden

Greif darauf zurück, wenn du ein chinesisches Astrologie-Produkt für einen Markt baust, der nicht Chinesisch liest: eine App, einen Lesedienst, einen Diagramm-Renderer, einen Agenten, der die Struktur braucht, bevor er interpretiert. Die Antwort ist reine Struktur ohne Fließtext, sodass sie sich nahtlos in ein Zwölf-Palast-Raster, einen Berichtsgenerator oder einen LLM-Prompt einfügt. Die Referenz-Endpoints derselben Familie sind günstiger und nützlich für Glossare und Tooltips, aber sie geben für jede Geburt dieselbe Tabelle zurück und vermerken das in einem Feld, also baue kein Diagramm daraus.

// 05 / Hinweise

Hinweise

Absichtlich an drei veröffentlichten Diagrammen festgemacht statt an einer Bibliothek: Fast das gesamte Open-Source-Zi-Wei-Ökosystem stammt von einem einzigen Projekt, also bedeutet das Zustimmen zu mehreren das Zustimmen zu einem. Zwei vollständige Diagramme reproduzieren exakt, ein drittes stammt aus einem unabhängigen Lehrtext. Vier Schul-Schalter leben im Request-Body statt im Code, weil jeder das gesamte Diagramm für die betroffenen Geburten verschiebt: die Jahresgrenze, der Schaltmonat, das 23:00-Rollover und die Transformationstabelle. Wenn ein anderer Rechner abweicht, prüfe diese vier zuerst, bevor du die Arithmetik ansiehst.

Zi Wei Dou Shu-API ausprobieren

Hol dir einen Key und mach deinen ersten Aufruf in unter einer Minute.

99,9% SLA · kostenpflichtige Tarife · 30 Tage Status →