Zi Wei Dou Shu: τοποθέτηση των αστέρων

紫微斗數 δημιουργεί έναν χάρτη όχι από πλανήτες, αλλά από δώδεκα παλάτια και πάνω από εκατό αστέρια, τοποθετημένα σύμφωνα με κανόνες που προκύπτουν από τη σεληνιακή ημερομηνία και την ώρα γέννησης. Το POST /v1/ziwei/chart υπολογίζει αυτό πλήρως.

Τελικά Σημεία

Τελικό Σημείο	Πιστώσεις	Τι επιστρέφει
POST /v1/ziwei/chart	20	Πλήρης χάρτης: παλάτια, αστέρια, στάδια, όρια, 四化. Απαιτεί time και gender
POST /v1/ziwei/four-transformations	10	四化 ανά ετήσιο στέλεχος, τέσσερις σχολές
POST /v1/ziwei/twelve-palaces	5	Αναφορά δώδεκα παλατιών
POST /v1/ziwei/main-stars	5	Αναφορά δεκατεσσάρων κύριων αστεριών
POST /v1/ziwei/palace-*	5	Αναφορά ενός παλατιού, εννέα μονοπάτια

Οι διαδρομές αναφοράς φέρουν το πεδίο computed: false και κοστίζουν το μισό της τιμής. Επιστρέφουν τον ίδιο πίνακα για οποιαδήποτε ημερομηνία γέννησης, και αυτό δεν είναι κακό, εφόσον αναφέρεται.

Το `/ziwei/full-chart` έχει καταργηθεί

Επιστρέφει το ίδιο λεξικό παλατιών σε οποιονδήποτε, ενώ το όνομά του υπόσχεται έναν χάρτη. Απαντά χωρίς αλλαγές έως 2027-11-26, φέρει τις κεφαλίδες Deprecation, Sunset και Link για τον διάδοχο. Μετάβαση στο /v1/ziwei/chart: απαιτεί gender επιπλέον της ημερομηνίας και της ώρας.

Παράδειγμα

curl -X POST https://api.astroway.info/v1/ziwei/chart \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2000-08-16","time":"04:00:00","gender":"male","age":25}'

{
  "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", "kind": "major" }],
      "lifeStage": { "chinese": "死", "name": "Death", "localised": "Death" },
      "boshi": "伏兵",
      "decade": { "index": 0, "fromAge": 3, "toAge": 12 }
    }
  ]
}

Ο πίνακας palaces περιέχει και τα δώδεκα στην ίδια μορφή, από 寅 έως 丑.

Τι ακριβώς υπολογίζεται

Βήμα	Κανόνας
命宮 και 身宮	Από το παλάτι του μήνα προς τα πίσω ανά ώρα για τη Ζωή, προς τα εμπρός για το Σώμα
Στελέχη παλατιών	五虎遁 από το στέλεχος του έτους
五行局	Από το στέλεχος του παλατιού της Ζωής· συμπίπτει με το 納音 σε όλα τα εξήντα ζεύγη
紫微	Διαίρεση της ημέρας με τον αριθμό 局 με δανεισμό: άρτιος δανεισμός προς τα εμπρός, περιττός προς τα πίσω
紫微系 (6)	Μετατόπιση −1, −3, −4, −5, −8 από το 紫微
天府系 (8)	Το 天府 είναι ο καθρέφτης του 紫微 γύρω από τον άξονα 寅-申, μετά +1..+6 και +10 για το 破軍
六吉 και 六煞	Από τον μήνα, την ώρα και το στέλεχος του έτους, το καθένα με τη δική του φόρμουλα
Τριάντα ένα μικρά αστέρια	Από τον κλάδο του έτους, το στέλεχος του έτους, τον μήνα, την ημέρα και την ώρα
長生十二神	Από το 五行局, προς τα εμπρός για 陽男陰女 και προς τα πίσω αλλιώς
博士十二神	Από το 祿存, την ίδια κατεύθυνση
將前 και 歲前 十二神	Από την τριάδα του κλάδου του έτους και από τον ίδιο τον κλάδο, και τα δύο πάντα προς τα εμπρός
大限	Από το 命宮, έναρξη στην ηλικία του αριθμού 局, βήμα δέκα ετών
小限	Διαβάζει το φύλο και δεν διαβάζει το ιν-γιαν, σε αντίθεση με τα δεκαετή
四化	Ανά ετήσιο στέλεχος, σημειωμένα απευθείας στα αστέρια

Τέσσερις διακόπτες σχολών

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

Παράμετρος	Προεπιλογή	Δεύτερη τιμή
yearDivide	lunar: το έτος ξεκινά την πρώτη ημέρα του πρώτου σεληνιακού μήνα	lichun: όριο από το BaZi
fixLeap	true: ο δίσεκτος μήνας διαιρείται από την δέκατη πέμπτη ημέρα	false: ολόκληρος ο δίσεκτος μήνας υπολογίζεται ως ο προηγούμενος
dayDivide	forward: 23:00 ανήκει στην επόμενη ημέρα	current: η ημερομηνία παραμένει, η ώρα σημειώνεται ως 晚子時
tianmaSchool	year: 天馬 από τον κλάδο του έτους (中州派)	month: 天馬 από τον σεληνιακό μήνα
school	zhongzhou: 四化 σύμφωνα με το σύστημα του 王亭之	quanji, quanshu, beipai

Η ώρα γέννησης είναι υποχρεωτική

Το Παλάτι της Ζωής τοποθετείται από την ώρα, και από αυτό εξαρτάται το 五行局 και κάθε αστέρι. Ένας χάρτης χωρίς ώρα δεν θα ήταν μια μερική απάντηση, αλλά δώδεκα παλάτια σίγουρης ανοησίας, γι’ αυτό ένα αίτημα χωρίς time απορρίπτεται με 400. Αυτό διαφέρει από το BaZi, όπου χωρίς ώρα απλά δεν υπάρχει ωριαίο στέλεχος.

Πραγματικός Ηλιακός Χρόνος

Από προεπιλογή, η ώρα διαβάζεται σύμφωνα με το τοπικό ρολόι, όπως τη διαβάζουν οι περισσότεροι επαγγελματίες. Πέρασε trueSolarTime: true μαζί με longitude και timezoneOffset, ώστε η ώρα να διαβάζεται σύμφωνα με τον ήλιο πάνω από τον τόπο γέννησης, με την ίδια διόρθωση όπως στο /v1/bazi. Στην Ισπανία ή στη δυτική Γαλλία, η διαφορά είναι από 50 έως 135 λεπτά, και αυτό είναι αρκετό για να αλλάξει η ώρα, και μαζί της το Παλάτι της Ζωής και κάθε αστέρι. Η διόρθωση εφαρμόζεται στην ώρα και στην ημέρα· με yearDivide=lichun το όριο Lichun παραμένει σύμφωνα με το ρολόι. Το τι ακριβώς εφαρμόστηκε, επιστρέφεται στο input.trueSolarTime. Το longitude χωρίς trueSolarTime δεν αλλάζει τίποτα, ενώ το trueSolarTime χωρίς longitude ή timezoneOffset δίνει 400 TRUE_SOLAR_TIME_NEEDS_PLACE.

Το έτος εδώ δεν ξεκινά με το Lichun

Αυτή δεν είναι επιλογή σχολής. Το 斗數 είναι ένα καθαρά σεληνιακό σύστημα και δεν μεταβαίνει σε ηλιακούς όρους, σε αντίθεση με το 子平. Το yearDivide=lichun υπάρχει μόνο για διασταύρωση με έναν υπολογιστή που έφερε το όριο από το BaZi.

Πώς ελέγχθηκε

Έχει καρφωθεί σε τρεις δημοσιευμένους χάρτες, όχι σε μία μόνο βιβλιοθήκη, και αυτό είναι σκόπιμο. Σχεδόν όλο το ανοιχτό οικοσύστημα Zi Wei προέρχεται από ένα έργο: δύο ports συν τουλάχιστον ένα έργο που δηλώνει διαφορετική γραμμή, αλλά εσωτερικά το καλεί και αναλύει την έξοδο. Επομένως, η συμφωνία με πολλά έργα είναι συμφωνία με ένα.

• Δύο χάρτες αναπαράχθηκαν πλήρως: και τα δεκατέσσερα κύρια αστέρια, το 五行局, τα παλάτια της Ζωής και του Σώματος.
• Τα δώδεκα στάδια ελέγχθηκαν σε ένα τρίτο διάνυσμα δεδομένων από την ίδια πηγή, όπου δημοσιεύονται τα αναμενόμενα δώδεκα, και όχι σε αυτά τα δύο. Οι αρχές των δεκαετιών ελέγχθηκαν με τον αριθμό του 五行局, δηλαδή με τον κανόνα από τον οποίο προκύπτουν, και όχι με μια εξωτερική δημοσίευση.
• Ο τρίτος χάρτης λήφθηκε από ένα κινεζικό εκπαιδευτικό κείμενο χωρίς σχέση με αυτό το οικοσύστημα και καρφώνει τη μετατόπιση των αστεριών και τη σειρά των παλατιών ανεξάρτητα.
• Η μνημονική 安紫微星 「六五四三二／酉午亥辰丑」 και η δημοσιευμένη πορεία του 火六局 για τις ημέρες 1-15 ελέγχονται απευθείας: αυτές είναι σταθερές της παράδοσης, όχι η υλοποίηση κάποιου.

Τι να κάνεις όταν ο υπολογιστής σου δίνει διαφορετικό αποτέλεσμα

Έλεγξε όχι την αριθμητική, αλλά τους τέσσερις διακόπτες: το όριο του έτους, τον δίσεκτο μήνα, το όριο της ημέρας στις 23:00 και τον πίνακα 四化. Σχεδόν πάντα οι διαφορές βρίσκονται εκεί.

Μια κοινή παράδοση που είναι λανθασμένη

Τα 火星 και 鈴星 τοποθετούνται προς τα εμπρός από την τριάδα του κλάδου του έτους και δεν διαβάζουν το φύλο σε καμία επαληθευμένη παράδοση. Ο κανόνας 陽男陰女順 / 陰男陽女逆, που μερικές φορές τους αποδίδεται, ανήκει στα δώδεκα στάδια 長生十二神 και στα δεκαετή όρια. Και τα δύο θέματα βρίσκονται στην ίδια σελίδα στην πιο συχνά αντιγραμμένη πηγή, και φαίνεται ότι από εκεί προήλθε η σύγχυση.

Γλώσσες

Τα ονόματα των παλατιών και των δώδεκα σταδίων έχουν μεταφραστεί σε 21 γλώσσες: πρόσθεσε ?lang=, και σε κάθε παλάτι θα εμφανιστεί το palaceLocalised, ενώ στο στάδιο το πεδίο localised. Τα ονόματα των αστεριών παραμένουν ιερογλυφικά με αγγλική μετάφραση δίπλα: δεν έχουν καθιερωμένα ονόματα.