AstroWay/api v2.173.1 · el
όλες οι υπηρεσίες λειτουργούν κανονικά
// astrology api · POST /v1/ziwei/chart

Zi Wei Dou Shu (Πορφυρέας Αστέρας) API

Μια ημερομηνία γέννησης, μια ώρα και το φύλο σου δημιουργούν ολόκληρο το χάρτη: δώδεκα παλάτια με τα κλαδιά τους, όλα τα δεκατέσσερα κύρια αστέρια, τα βοηθητικά, τριάντα ένα μικρά αστέρια, τα δώδεκα στάδια ζωής, τα όρια της δεκαετίας και οι τέσσερις μετασχηματισμοί σημειωμένοι στα αστέρια που τα φέρουν.

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

Zi Wei Dou Shu (Πορφυρέας Αστέρας) API

Η γέννηση μετατρέπεται σε σεληνιακή ημερομηνία, γιατί το Zi Wei είναι καθαρά σεληνιακό σύστημα και, σε αντίθεση με το BaZi, δεν περνά στους ηλιακούς όρους. Από το σεληνιακό μήνα και τη διπλή ώρα το endpoint τοποθετεί το παλάτι ψυχής και το παλάτι σώματος, μετά εφαρμόζει το five-tigers rule σε κάθε παλάτι, μετά διαβάζει την five-element class από τη στήλη του παλατιού ψυχής. Αυτή η κλάση και η σεληνιακή ημέρα τοποθετούν το 紫微 με τον κλασικό κανόνα borrow-and-divide, τα έξι αστέρια της σειράς του ακολουθούν με σταθερές μετατοπίσεις, το 天府 το αντανακλά κατά τον άξονα 寅-申 και φέρνει τα δικά του οκτώ. Πάνω σε αυτό το σκελετό προστίθενται τα έξι τυχερά και τα έξι κακόβουλα αστέρια, το salary store και το heavenly horse, τριάντα ένα μικρά αστέρια που συνδέονται με το κλαδί του έτους, το κλαδί του έτους, το μήνα, την ημέρα και την ώρα, τα δώδεκα στάδια ζωής, ο κύκλος του scholar, ο κύκλος του general και ο κύκλος του έτους, τα δεκαετή όρια που ανοίγουν στον αριθμό της κλάσης, και το ετήσιο όριο αν ζητήσεις την ηλικία. Οι τέσσερις μετασχηματισμοί λύνουν από το κλαδί του έτους και συνδέονται με τα ίδια τα αστέρια αντί να επιστρέφονται ως ξεχωριστή λίστα.

// 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

Χρησιμοποίησέ το όταν φτιάχνεις προϊόν αστρολογίας Κίνας για αγορά που διαβάζει κάτι άλλο εκτός από Κινέζικα: μια εφαρμογή, μια υπηρεσία ανάγνωσης, έναν αποτυπωτή χάρτη, έναν πράκτορα που χρειάζεται τη δομή πριν την ερμηνεύσει. Η απάντηση είναι καθαρά δομή χωρίς κείμενο, έτσι ενσωματώνεται σε πλέγμα δώδεκα παλατιών, σε γεννήτρια αναφορών ή σε prompt LLM εξίσου καλά. Τα reference endpoints στην ίδια οικογένεια είναι φθηνότερα και χρήσιμα για γλωσσάρια και tooltips, αλλά επιστρέφουν τον ίδιο πίνακα για κάθε γέννηση και το δηλώνουν σε πεδίο, οπότε μην φτιάχνεις χάρτη από αυτά.

// 05 / Notes

Notes

Καρφιτσωμένο σε τρία δημοσιευμένα charts αντί για μία βιβλιοθήκη, σκόπιμα: σχεδόν όλο το open-source οικοσύστημα του Zi Wei προέρχεται από ένα μόνο project, οπότε το να συμφωνείς με πολλά σημαίνει να συμφωνείς με ένα. Δύο πλήρη charts αναπαράγουν ακριβώς, και ένα τρίτο προέρχεται από ανεξάρτητο κείμενο διδασκαλίας. Τέσσερις διακόπτες σχολής ζουν στο σώμα του request αντί στον κώδικά μας, γιατί καθένας μετακινεί ολόκληρο το chart για τις γεννήσεις που αγγίζει: το όριο του έτους, το δίσεκτο μήνα, το rollover 23:00 και τον πίνακα μετασχηματισμών. Όταν ένας άλλος υπολογιστής διαφωνεί, έλεγξε αυτά τα τέσσερα πριν το άθροισμα.

Try the Zi Wei Dou Shu API

Grab a key and make your first call in under a minute.

99.9% SLA · επί πληρωμή πλάνα · 30 ημέρες κατάσταση →