API Διαγράμματος Διοδών

Το endpoint των διόδων παίρνει τα γενέθλια δεδομένα ενός ατόμου – ημερομηνία γέννησης, ώρα, διαφορά UTC, γεωγραφικό πλάτος, μήκος και σύστημα σπιτιών – και μια ξεχωριστή στιγμή-στόχο. Μετατρέπει αυτή τη ημερομηνία-στόχο και την ώρα σε Julian day, ζητά από τη μηχανή Swiss Ephemeris τη γεωκεντρική γεωγραφία, το πλάτος και την ταχύτητα κάθε διόδου σώματος, μετά τοποθετεί αυτές τις θέσεις στα σπίτια που προκύπτουν από τη γενέθλια θέση. Η απάντηση περιλαμβάνει τους διόδους πλανήτες με τα ζώδια και τις θέσεις στα σπίτια, τα γενέθλια όρια των σπιτιών, και το πλήρες πλέγμα όψεων που υπολογίζεται μεταξύ των διόδων σωμάτων, το καθένα με σημαίες εφαρμογής ή διαχωρισμού και ακριβή ακτίνια. Επιστρέφει επίσης παράλληλα και αντισχίδες (σημεία καθρεπτισμού) όψεις για την κλίση και την εργασία του ηλιοστασιακού άξονα. Η οπισθοδρόμηση σημαδεύεται από την ταχύτητα του σώματος, ώστε να βλέπεις ποιες διόδους είναι άμεσες, σταθερές ή κινούνται προς τα πίσω τη ζητούμενη στιγμή.

curl -X POST https://api.astroway.info/v1/transits \
  -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,
  "transitDate": "2026-06-15",
  "transitTime": "12:00:00",
  "transitTzOffset": 3
}'

{
  "ok": true,
  "data": {
    "input": {},
    "julianDay": 2461206.875,
    "planets": [
      {
        "name": "Sun",
        "longitude": 84.29,
        "sign": "Gemini",
        "house": 11
      }
    ],
    "houses": {
      "ascendant": 160.4,
      "mc": 70.1,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      {
        "planet1": "Sun",
        "planet2": "Moon",
        "type": "conjunction",
        "orb": 1.2,
        "applying": true
      }
    ],
    "parallelAspects": [
      "…"
    ],
    "antiscia": [
      "…"
    ]
  }
}

Χρησιμοποίησέ το όταν θέλεις ολόκληρο τον ουρανό όπως φαίνεται πάνω στο χάρτη κάποιου για μια συγκεκριμένη μέρα – ένα widget daily-transits, ένα πάνελ τύπου καιρού «τι είναι πάνω τώρα», ή το ακατέργαστο πλαίσιο που διαβάζει ένας AI agent πριν περιγράψει το τρέχον αστρολογικό κλίμα. Επειδή επιστρέφει το διάγραμμα transit πάνω στο πλαίσιο των natal houses αντί για μια επιλεγμένη λίστα transit-to-natal contacts, είναι η σωστή επιλογή όταν χρειάζεσαι το δομικό στιγμιότυπο. Αν όμως θέλεις χρονομετρημένες transit-to-natal hits σκανάρισες σε εύρος ημερομηνιών – ακριβείς ημερομηνίες, ingresses, station points – πήγαινε στο endpoint transit-calendar, που είναι φτιαγμένο γι' αυτή τη δουλειά. Συνδύασε τα δύο: αυτό το endpoint για το διάγραμμα της στιγμής, το calendar για τη λίστα μελλοντικών γεγονότων.

Δες τις σημερινές διόδους στο δικό σου χάρτη →

Να είσαι ακριβής σχετικά με το εύρος: αυτό επιστρέφει το διάγραμμα transit πάνω στο πλαίσιο των natal houses, όχι μια προ-φιλτραρισμένη λίστα transit-to-natal όψεων. Το πλέγμα όψεων υπολογίζεται μεταξύ των διόδων σωμάτων, όχι μεταξύ transit και natal σημείων. Για χρονισμό to-natal σε εύρος ημερομηνιών, χρησιμοποίησε /transit-calendar. Τα σπίτια ακολουθούν το επιλεγμένο natal σύστημα· tropical zodiac και Swiss Ephemeris σε όλη τη διάρκεια.