Τονγκ Σου (επιλογή ημερομηνίας)

Το Τονγκ Σου (通書) είναι το κινεζικό αλμανάκ με το οποίο παραδοσιακά επιλέγεται μια ημέρα. Δύο από τα επίπεδά του υπολογίζονται με ακρίβεια, και αυτά ακριβώς έχουν υλοποιηθεί εδώ: οι δώδεκα αξιωματούχοι της ημέρας (建除十二神) και οι είκοσι οκτώ σεληνιακοί οίκοι (二十八宿).

Endpoints

Endpoint	Credits	Τι επιστρέφει
POST /v1/chinese/tong-shu	10	Μία ημέρα: στήλη ημέρας, αξιωματούχος, σεληνιακός οίκος, ζώο σύγκρουσης
POST /v1/chinese/tong-shu/select	20	Οι ημέρες ενός διαστήματος που το μητρώο εγκρίνει για μία ενέργεια

Οι δώδεκα αξιωματούχοι της ημέρας

Ο κανόνας είναι ένας. Η ημέρα της οποίας ο γήινος κλάδος συμπίπτει με τον κλάδο του μήνα είναι 建 Establish, και από εκεί οι δώδεκα ακολουθούν κυκλικά. Ο μήνας εδώ ορίζεται από την ακριβή στιγμή του ηλιακού όρου, όχι από την πρώτη του μήνα, γι’ αυτό ο αξιωματούχος μπορεί να αλλάξει στη μέση ενός ημερολογιακού μήνα.

#	中文	Όνομα	Τι είδους ημέρα
1	建	Establish	Αρχή, όχι ολοκλήρωση
2	除	Remove	Καθάρισμα, απαλλαγή
3	滿	Full	Πληρότητα, υπογραφή, εγκαίνια
4	平	Balance	Ομαλή, καθημερινή, ασφαλής
5	定	Stable	Ό,τι πρέπει να διαρκέσει
6	執	Control	Ανάληψη ελέγχου
7	破	Destruction	Ημέρα που συγκρούεται με τον μήνα
8	危	Danger	Ύψος και κίνδυνος
9	成	Success	Η πιο ευνοϊκή από τις δώδεκα
10	收	Collect	Συλλογή, παραλαβή
11	開	Open	Άνοιγμα, υποδοχή
12	閉	Close	Σφράγισμα· η πιο χαμηλή

Οι είκοσι οκτώ σεληνιακοί οίκοι

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

Παράδειγμα

Μία ημέρα

curl -X POST https://api.astroway.info/v1/chinese/tong-shu \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "date": "2026-09-12" }'

Επιλογή ημερομηνίας

curl -X POST https://api.astroway.info/v1/chinese/tong-shu/select \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "from": "2026-09-01", "to": "2026-12-31",
        "activity": "marriage", "avoidClashWith": "Rat" }'

Ενέργειες: marriage, opening, moving, travel, contract, construction, demolition, medical, funeral, education.

Σημείωση

Τρεις ετυμηγορίες, και το neutral δεν σημαίνει “αδιάφορο”. Τα suitable και unsuitable είναι ό,τι το μητρώο λέει ρητά. Το neutral σημαίνει ότι η παράδοση σιωπά για αυτή την ενέργεια. Γι’ αυτό οι σιωπηλές ημέρες εξ ορισμού δεν μπαίνουν στο αποτέλεσμα, και μπορείς να τις ζητήσεις με το includeNeutral.

Προσοχή

Το διάστημα περιορίζεται σε 366 ημέρες, και ένα μεγαλύτερο απορρίπτεται, δεν περικόπτεται. Μια σιωπηλά κομμένη απάντηση θα διαβαζόταν ως “μετά τον Μάρτιο δεν υπάρχουν καλές ημέρες”, ενώ στην πραγματικότητα κανείς δεν κοίταξε εκεί. Η απάντηση περιέχει πάντα scanned, matched και dropped με ανάλυση, ώστε τα αθροίσματα να συμφωνούν.

Τι ελέγχθηκε

• Οι αξιωματούχοι επαληθεύτηκαν με ένα δημοσιευμένο λυμένο παράδειγμα: Δεκέμβριος 2020 στον μήνα του Αρουραίου, όπου η 11η Δεκεμβρίου είναι το πρώτο Establish, και οι 8, 9 και 10 Δεκεμβρίου είναι Collect, Open και Close. Συμφωνούν και οι τέσσερις.
• Οι σεληνιακοί οίκοι επαληθεύτηκαν με την ημερήσια ακολουθία ενός ιαπωνικού αλμανάκ για τον Αύγουστο του 2026: είκοσι συνεχόμενες ημέρες, από το 女 της πρώτης Αυγούστου έως το 角 της εικοστής. Επιπλέον, το αναλλοίωτο της ημέρας της εβδομάδας ελέγχθηκε σε έναν αιώνα ημερομηνιών.
• Η στήλη της ημέρας είναι πλέον κλειδωμένη με τρεις δημοσιευμένες ημερομηνίες (1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰). Παλαιότερα αναφέρονταν μόνο σε ένα σχόλιο και δεν τις έλεγχε τίποτα.

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