get_transits
Alttaki bodygraph verilerini göndermek için sözleşmenin `natalChart` alanını kullanın, ardından güncel veya tarihli transit bağlamını isteyin. API uyumluluğu için bu tanımlayıcı aynen korunur.
Geliştiriciye sağladığı: İstemcide gezegen konumlarını hesaplamadan zamana duyarlı ajan deneyimleri oluşturun.
Parametreler
| Ad Soyad | Tür | Gerekli | Açıklama |
|---|---|---|---|
date | string (yerel saat) | Evet | Belirtilen saat diliminde yerel saat olarak açık transit anı; Z ve UTC farkı içermez. MCP bu alanı zorunlu tutar; böylece anahtarlı yeniden deneme aynı anı hedefler. Gelecekte olabilir. |
timezone | string | Hayır | Transit anına ait IANA saat dilimi. |
natalChart | object | Hayır | Doğum bilgileri birthDateTime ve timezone alanlarını içeren isteğe bağlı bodygraph girdisi. birthDateTime, Z ve UTC farkı içermeyen yerel saat değeridir. Alan adı arka uç sözleşmesinin bir parçasıdır. |
idempotencyKey | string | Evet | Bu transit hesaplamasına özel sabit anahtar. Yalnızca yeniden denerken aynı bağımsız değişkenlerle kullanın. |
Doğum saatleri yerel saat olarak belirtilir. Doğum tarihini ve saatini, kişinin doğduğu yerde saat nasıl gösteriliyorsa öyle, Z ve UTC farkı olmadan gönderin; saat dilimini ayrıca IANA tanımlayıcısı olarak belirtin. "birthDateTime": "1990-05-15T14:30:00" ve "timezone": "America/New_York", New York'ta öğleden sonra ikiyi otuz geçe anlamına gelir.
Kullanımdan kaldırıldı: Z ile biten veya sayısal fark içeren değerler kullanımdan kaldırılıyor. MCP bu değerleri iletir ve API şimdilik UTC olarak okuyup kabul eder; kullanımdan kaldırma bildirimi API yanıtında yer alır. Bu değerler artık kabul edilmeyecek ve tarih önceden duyurulacaktır. Kuralın tamamını okuyun.
İstek
Arındırılmış 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"
}
}
}Başarılı yanıt biçimi
- Transit anındaki gezegen konumları
- Etkinleşen kapılar ve kanallar
- Belirtilen bodygraph girdisiyle bağlantılar
Yanıt ayrıca API yetkilendirme katmanının sağladığı plan ve kota üst verilerini içerir. Alana özgü ayrıntılar, araca ve istenen ayrıntı düzeyine göre değişir.
Hatalar
- Startup planı gerekir
- Geçersiz bodygraph girdisi
- Geçersiz transit tarihi
- Kota aşıldı
Kota kullanımı
Girdi doğrulaması, yetkilendirme ve plan denetimleri başarılı olduktan sonra hesaplama sağlayıcısına ulaşan her yürütme girişimi, sonraki bir sunum adımı başarısız olsa bile ortak API kotasından tam bir birim tüketir. Hatalı veya belirsiz girdiler, reddedilen planlar, bilinmeyen referanslar ve sağlayıcıya ulaşılmadan önceki diğer hatalar sıfır tüketir. Güncel kullanımı şuradan kontrol edin: my.humandesign.ai.