API επιλογής ημερομηνίας Tong Shu

Κάθε μέρα στο διάστημα αναλύεται στον ημερήσιο πυλώνα της από τον εξηκονταετή κύκλο, και στη συνέχεια διαβάζεται μέσω δύο ανεξάρτητων καταχωρίσεων. Οι δώδεκα ημερήσιοι αξιωματούχοι 建除十二值星 κυκλοφορούν με τον κλάδο του μήνα και ο καθένας φέρει τη δική του λίστα με το τι ταιριάζει και τι απαγορεύει: Το Full ταιριάζει για υπογραφή και εορτασμό, το Close σχεδόν για τίποτα. Οι είκοσι οκτώ σεληνιακοί οίκοι κυκλοφορούν σε επταήμερο ρυθμό ανεξάρτητα από τους αξιωματούχους και φέρουν τις δικές τους εγκρίσεις. Μια μέρα περνάει μόνο όταν η επιλεγμένη δραστηριότητα επιβιώνει και από τις δύο καταχωρίσεις. Το προαιρετικό φίλτρο σύγκρουσης αφαιρεί στη συνέχεια τις ημέρες των οποίων ο κλάδος βρίσκεται απέναντι από το ζώο που ονομάζεις, κάτι που είναι ο τρόπος με τον οποίο η παράδοση αποκλείει το άτομο για το οποίο επιλέγεται η ημέρα. Η απάντηση αναφέρει τα σαρωμένα, τα ταιριαστά και την ανάλυση του τι απορρίφθηκε ανά καταχώριση και ανά σύγκρουση, έτσι ώστε μια κενή απάντηση να είναι ευανάγνωστη και όχι μυστηριώδης.

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

{
  "ok": true,
  "data": {
    "activity": "marriage",
    "from": "2026-06-01",
    "to": "2026-06-14",
    "scanned": 14,
    "matched": 5,
    "dropped": { "byRegister": 9, "byClash": 0 },
    "days": [
      {
        "date": "2026-06-02",
        "verdict": "suitable",
        "dayPillar": "Ding-Wei",
        "officer": { "chinese": "滿", "name": "Full", "summary": "Fullness and return. Signing, opening, celebrating." },
        "mansion": { "chinese": "尾", "name": "Tail", "quadrant": "Azure Dragon" },
        "clashesWith": "Ox"
      }
    ]
  }
}

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

Και οι δύο καταχωρίσεις προέρχονται από την παράδοση του έντυπου αστρολογικού οδηγού και όχι από μια επινοημένη κατάταξη, και το endpoint ποτέ δεν επινοεί μια ημέρα: ένα κενό αποτέλεσμα παραμένει κενό και αναφέρει ποια καταχώριση το άδειασε. Το όριο της ημέρας είναι 23:00, συνεπές με κάθε άλλο κινεζικό endpoint εδώ. Τα ονόματα δραστηριοτήτων ακολουθούν τη δική της λίστα της καταχώρισης, οπότε μια άγνωστη δραστηριότητα απορρίπτεται με ένα 400 που ονομάζει το πεδίο.