Αριθμολογία στο API: 5 συστήματα υπολογισμού με μία διαδρομή

Αριθμολογία - ένα μέρος του εσωτεριστικού stack, το οποίο το API συνήθως είτε παραλείπει εντελώς, είτε το μειώνει σε έναν πυφαγόρειο «life path number». Πήγαμε διαφορετική διαδρομή: 5 πλήρη συστήματα, το καθένα με 10 κανονικούς υπολογισμούς, με μία παραμετροποιημένη διαδρομή.

Συνολικά είναι 50 endpoints κάτω από /numerology/{system}/{calc}, συν μια ξεχωριστή Μητρώο Μοίρας. Παρακάτω - πώς είναι οργανωμένο και γιατί αρκεί μία διαδρομή.

Όλοι οι υπολογισμοί ζουν κάτω από το πρότυπο:

POST /v1/numerology/{system}/{calc}

{system} - ένα από τα πέντε τιμές. Κάθε σύστημα έχει τον δικό του πίνακα αντιστοιχίας «γράμμα → αριθμός» και τους δικούς του κανόνες μείωσης, έτσι το αποτέλεσμα για το ίδιο όνομα διαφέρει ανάλογα με τη σχολή:

Άγνωστο σύστημα επιστρέφει 400 INVALID_SYSTEM με τη λίστα των επιτρεπτών τιμών - χωρίς σιωπηλά fallback στην πυφαγόρεια.

Το ίδιο σύνολο 10 υπολογισμών είναι διαθέσιμο για οποιοδήποτε από τα πέντε συστήματα:

• life-path - αριθμός του μονοπατιού ζωής (από την ημερομηνία γέννησης)
• expression - αριθμός έκφρασης / μοίρας (από το πλήρες όνομα)
• soul-urge - αριθμός ψυχής (φωνήεντα ονόματα)
• personality - αριθμός προσωπικότητας (συμφωνικά ονόματα)
• birthday - αριθμός ημέρας γέννησης
• maturity - αριθμός ωριμότητας (life-path + expression)
• balance - αριθμός ισορροπίας (αρχικά)
• challenge - αριθμοί προκλήσεων
• pinnacles - αριθμοί κορυφών (ζωές περίοδοι)
• personal-year - αριθμός προσωπικού έτους

Το σώμα του αιτήματος για τις περισσότερες κλήσεις - απλώς όνομα και ημερομηνία:

{ "name": "Ada Lovelace", "date": "1815-12-10" }

personal-year επιπλέον δέχεται year, επειδή υπολογίζει τη δόνηση του συγκεκριμένου ημερολογιακού έτους.

curl -X POST https://api.astroway.info/v1/numerology/pythagorean/life-path \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Ada Lovelace","date":"1815-12-10"}'

Η απάντηση περιέχει όχι μόνο τον αριθμό, αλλά και ολόκληρη τη σειρά μείωσης και έτοιμη ερμηνεία:

{
  "ok": true,
  "data": {
    "system": "pythagorean",
    "name": "Ada Lovelace",
    "date": "1815-12-10",
    "lifePath": {
      "raw": 10,
      "reduced": 1,
      "isMaster": false,
      "steps": [10, 1],
      "meaning": {
        "number": 1,
        "archetype": "The Pioneer",
        "strengths": ["leadership", "independence", "innovation", "initiative"],
        "challenges": ["ego", "impatience", "isolation", "stubbornness"],
        "career": ["entrepreneur", "executive", "inventor", "pioneer"],
        "relationship": "needs a partner who respects independence; thrives on mutual challenge",
        "shortRead": "born to lead and originate; learn to balance solo drive with collaboration"
      }
    }
  }
}

Το πεδίο steps δείχνει κάθε βήμα της μείωσης (10 → 1), και το isMaster ενεργοποιείται για 11, 22 και 33 - δεν μειώνονται σύμφωνα με τη συμφωνία της πυφαγόρειας σχολής. Αυτό είναι σημαντικό αν εσύ χτίζεις το δικό σου UI: δεν χρειάζεται να μαντεύεις γιατί το 29 έγινε 11 και όχι 2 - η αλυσίδα παρέχεται ρητά.

Το Μητρώο Μοίρας (Destiny Matrix) - δεν είναι μέρος της κλασικής αριθμολογίας, γι’ αυτό ζει σε ξεχωριστή διαδρομή:

POST /v1/destiny-matrix

Αυτή είναι μια μέθοδος με 22 μεγαλύτερα άρκανα Ταρώ, που τοποθετούνται σε οκταγράμμη από την ημερομηνία γέννησης. Επιστρέφει τις θέσεις του κεντρικού σταυρού, των γραμμών προγόνων, των ζωνών χρημάτων και σχέσεων - μια έτοιμη δομή για την απόδοση του μητρώου. Το κρατάμε εκτός /numerology/*, επειδή είναι διαφορετικό μοντέλο (άρκανα, όχι μείωση ψηφίων).

Οι αριθμολογικοί υπολογισμοί - καθαρή αριθμητική πάνω σε συμβολοσειρά και ημερομηνία, χωρίς εφέμερι. Γι’ αυτό είναι καθοριστικοί και φθηνοί: η ίδια είσοδος δίνει πάντα την ίδια έξοδο, η προσωρινή αποθήκευση είναι τριβιακή. Οι ερμηνείες (meaning) - στατικούς πίνακες, όχι LLM, έτσι δεν έχουν ούτε ψευδαισθήσεις ούτε μεταβλητότητα μεταξύ κλήσεων.

Αν χρειάζεσαι ελεύθερο κείμενο πάνω από τους αριθμούς, αυτό είναι ήδη ξεχωριστό στρώμα /interpret/* με AI - αλλά οι βασικοί αριθμοί πάντα προέρχονται από τον καθορισμένο πυρήνα.

Η αριθμολογία περιλαμβάνεται στο εσωτερικό add‑on πακέτο μαζί με το Ταρώ, τις ρούνες, τη γεωμαντεία και το I Ching. Κάθε κλήση - σταθερό κόστος σε credits (υπολογιστικά, όχι AI‑endpoints, γι’ αυτό φθηνά). Δωρεάν τιμή - 10 000 credits ανά μήνα, αρκετά για να συγκεντρώσεις πλήρες αριθμολογικό προφίλ για μερικές εκατοντάδες χρήστες ανά μήνα χωρίς πληρωμή.

1. Κλειδί στο dashboard/sign-up
2. Επίλεξε σύστημα για το κοινό σου (η πυφαγόρεια - προεπιλογή για τη δυτική αγορά, η βεδική - για την ινδική)
3. Συγκέντρωσε προφίλ με 10 κλήσεις ή τράβα ένα αριθμό τη φορά για συγκεκριμένη οθόνη

Πλήρης λίστα πεδίων και σχημάτων - στο OpenAPI‑οδηγό κάτω από την ομάδα Numerology.