get_transits
Χρησιμοποιήστε το πεδίο συμβολαίου `natalChart` για να υποβάλετε τα υποκείμενα δεδομένα bodygraph και, έπειτα, ζητήστε το πλαίσιο διέλευσης για τώρα ή συγκεκριμένη ημερομηνία. Το κυριολεκτικό αναγνωριστικό διατηρείται για συμβατότητα API.
Αποτέλεσμα για προγραμματιστές: Δημιουργήστε εμπειρίες agent με επίγνωση του χρόνου, χωρίς να υπολογίζετε πλανητικές θέσεις στον client.
Παράμετροι
| Όνομα | Τύπος | Απαιτείται | Περιγραφή |
|---|---|---|---|
date | string (τοπική ώρα ρολογιού) | Ναι | Ρητή στιγμή διέλευσης ως τοπική ώρα ρολογιού στην παρεχόμενη ζώνη ώρας, χωρίς Z και χωρίς μετατόπιση UTC. Το MCP την απαιτεί ώστε μια επανάληψη με κλειδί να αφορά την ίδια ακριβώς στιγμή. Μπορεί να είναι μελλοντική. |
timezone | string | Όχι | Ζώνη ώρας IANA για τη στιγμή διέλευσης. |
natalChart | object | Όχι | Προαιρετικά δεδομένα γέννησης bodygraph με birthDateTime και timezone. Το birthDateTime είναι τοπική ώρα ρολογιού χωρίς Z και χωρίς μετατόπιση UTC. Το όνομα πεδίου αποτελεί μέρος του συμβολαίου backend. |
idempotencyKey | string | Ναι | Σταθερό κλειδί για τον συγκεκριμένο υπολογισμό διέλευσης. Επαναχρησιμοποιήστε το μόνο με πανομοιότυπα ορίσματα κατά την επανάληψη. |
Οι ώρες γέννησης είναι τοπικές ώρες ρολογιού. Στείλτε ημερομηνία και ώρα γέννησης όπως έδειχνε το ρολόι στον τόπο γέννησης, χωρίς Z και χωρίς μετατόπιση UTC, και δώστε χωριστά τη ζώνη ώρας ως αναγνωριστικό IANA. Το "birthDateTime": "1990-05-15T14:30:00" μαζί με "timezone": "America/New_York" σημαίνει δύο και μισή το απόγευμα στη Νέα Υόρκη.
Καταργείται: Οι τιμές που τελειώνουν σε Z ή περιέχουν αριθμητική μετατόπιση καταργούνται. Το MCP τις προωθεί και το API εξακολουθεί προς το παρόν να τις δέχεται, ερμηνεύοντάς τες ως UTC· η απόσυρση ανακοινώνεται στην απάντηση API. Θα πάψουν να γίνονται δεκτές και η ημερομηνία θα ανακοινωθεί εγκαίρως. Διαβάστε τον πλήρη κανόνα.
Αίτημα
Απολυμασμένο JSON-RPC
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "get_transits",
"arguments": {
"date": "2026-08-06T12:00:00",
"timezone": "UTC",
"natalChart": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York"
},
"idempotencyKey": "transits-2026-08-06-v1"
}
}
}Δομή επιτυχούς απάντησης
- Πλανητικές θέσεις διέλευσης
- Ενεργοποιημένες πύλες και κανάλια
- Συνδέσεις με τα παρεχόμενα δεδομένα bodygraph
Η απάντηση περιλαμβάνει επίσης μεταδεδομένα επιπέδου και ορίου χρήσης από το επίπεδο δικαιωμάτων API. Τα ακριβή πεδία εξαρτώνται από το εργαλείο και το επίπεδο λεπτομέρειας που ζητήθηκε.
Σφάλματα
- Απαιτείται επίπεδο Startup
- Μη έγκυρα δεδομένα bodygraph
- Μη έγκυρη ημερομηνία διέλευσης
- Υπέρβαση ορίου χρήσης
Συμπεριφορά ορίου χρήσης
Αφού περάσουν οι έλεγχοι επικύρωσης εισόδου, εξουσιοδότησης και επιπέδου, μια προσπάθεια εκτέλεσης που φτάνει στον πάροχο υπολογισμού καταναλώνει ακριβώς μία κοινή μονάδα API — ακόμη κι αν αποτύχει μεταγενέστερο βήμα παρουσίασης. Κακοσχηματισμένα ή ασαφή δεδομένα, μη εγκεκριμένα επίπεδα, άγνωστες αναφορές και άλλες αποτυχίες πριν από τον πάροχο καταναλώνουν μηδέν. Ελέγξτε την τρέχουσα χρήση στη διεύθυνση my.humandesign.ai.