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

API Ετήσιων Προφάσεων

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

Endpoint
POST /v1/profections
Cost
20 credits
Latency
~48 ms
Tier
Tier 2
// 01 / What it computes

API Ετήσιων Προφάσεων

Το endpoint λαμβάνει τα δεδομένα γέννησης και μια ημερομηνία-στόχο, μετράει τα συμπληρωμένα έτη από τη στιγμή της γέννησης και προχωράει ένα ολόκληρο ζώδιο από τον Ωροσκόπο για κάθε ένα από αυτά. Η απάντηση αναφέρει την ηλικία που μέτρησε, τον μηδενικής βάσης δείκτη του ζωδίου στο οποίο προσγειώνεται το έτος, και τον πλανήτη που κυβερνά αυτό το ζώδιο ως lordOfYear, μαζί με τον γενέθλιο Ωροσκόπο, το Μεσουράνημα, τον Ήλιο και τη Σελήνη, ώστε να μπορείς να αποδώσεις το έτος σε σχέση με τον χάρτη χωρίς δεύτερη κλήση. Ο αριθμός του οίκου προκύπτει απευθείας από την ηλικία: ο κύκλος είναι δώδεκα ετών, οπότε ο προφασικός οίκος είναι η ηλικία modulo δώδεκα, συν ένα. Η ηλικία 36 επιστρέφει στον πρώτο οίκο και επομένως στο ίδιο το ζώδιο του Ωροσκόπου, γι' αυτό και το δείγμα χάρτη, με Ωροσκόπο στις 169.97 μοίρες στην Παρθένο, αναφέρει signIndex 5 και Ερμή ως τον κύριο αυτού του έτους. Επειδή η μέτρηση ξεκινά από τη στιγμή της γέννησης και όχι από το ημερολόγιο, το προφασικό έτος αλλάζει στα γενέθλια και όχι την πρώτη Ιανουαρίου.

// 02 / Live request

POST/v1/profections

curl -X POST https://api.astroway.info/v1/profections \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "targetDate": "2026-05-15"
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "age": 36,
    "signIndex": 5,
    "lordOfYear": "Mercury",
    "ascendant": 169.9680,
    "mc": 77.0743,
    "sun": 54.3760,
    "moon": 296.9047
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Birth date.
time string (HH:MM:SS) yes Local clock time at birth.
timezoneOffset number (hours) yes UTC offset in effect at the birth moment.
latitude number yes Birth-place latitude, decimal degrees (north positive).
longitude number yes Birth-place longitude, decimal degrees (east positive).
targetDate string (YYYY-MM-DD) yes The date whose profection year you want. Age is counted from the birth moment, so the year turns on the birthday, not on January 1.
// 04 / When to use it

When to use it

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

// 05 / Notes

Notes

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

Try the Ετήσιες Προφάσεις API

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

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