get_transits
Bruk kontraktfeltet `natalChart` til å sende de underliggende bodygraphdataene, og be deretter om transittkontekst for nåværende eller valgte datoer. Den bokstavelige identifikatoren beholdes av hensyn til API-kompatibilitet.
Resultat for utviklere: Bygg tidsbevisste agentopplevelser uten å beregne planetposisjoner i klienten.
Parametere
| Navn | Type | Obligatorisk | Beskrivelse |
|---|---|---|---|
date | streng (lokalt klokkeslett) | Ja | Eksplisitt transittidspunkt som lokalt klokkeslett i oppgitt tidssone, uten Z eller UTC-forskyvning. MCP krever dette slik at et nytt forsøk med nøkkel gjelder samme øyeblikk. Tidspunktet kan ligge i fremtiden. |
timezone | streng | Nei | IANA-tidssone for transittidspunktet. |
natalChart | objekt | Nei | Valgfrie fødselsdata for bodygraph med birthDateTime og timezone. birthDateTime er lokalt klokkeslett uten Z eller UTC-forskyvning. Feltnavnet er en del av backendkontrakten. |
idempotencyKey | streng | Ja | Stabil nøkkel for denne tilsiktede transittberegningen. Bruk den på nytt bare med identiske argumenter ved et nytt forsøk. |
Fødselstidspunkter er lokale klokkeslett. Send fødselsdato og -tid nøyaktig slik klokken viste på fødestedet, uten Z eller UTC-forskyvning, og oppgi tidssonen separat som en IANA-identifikator. "birthDateTime": "1990-05-15T14:30:00" med "timezone": "America/New_York" betyr halv tre på ettermiddagen i New York.
Avviklet: Verdier som slutter på Z eller har en numerisk forskyvning, er avviklet. MCP videresender dem, og API-et godtar dem foreløpig fortsatt som UTC og beregner deretter. Avviklingen oppgis i API-svaret. De vil ikke lenger bli godtatt; datoen kunngjøres på forhånd. Les hele regelen.
Forespørsel
Sanert 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"
}
}
}Svarformat ved suksess
- Planetposisjoner ved transitt
- Aktiverte porter og kanaler
- Forbindelser til oppgitte bodygraphdata
Svaret inneholder også metadata for nivå og kvote fra API-ets tilgangslag. De nøyaktige domenefeltene varierer etter verktøy og ønsket detaljnivå.
Feil
- Startup-nivå kreves
- Ugyldige bodygraphdata
- Ugyldig transittdato
- Kvote overskredet
Kvoteatferd
Når validering av inndata, autorisasjon og nivåkontroller er bestått, bruker et forsøk som når beregningstjenesten nøyaktig én delt API-enhet, selv om et senere presentasjonstrinn mislykkes. Feilformatert eller tvetydig inndata, avviste nivåer, ukjente referanser og andre feil før tjenesten bruker null. Se gjeldende bruk på my.humandesign.ai.