get_transits
Brug kontraktfeltet `natalChart` til at indsende de underliggende bodygraphdata, og anmod derefter om transitkontekst for nu eller en bestemt dato. Den bogstavelige identifikator bevares af hensyn til API-kompatibilitet.
Resultat for udviklere: Byg tidsfølsomme agentoplevelser uden at beregne planetpositioner i klienten.
Parametre
| Navn | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
date | streng (lokalt klokkeslæt) | Ja | Eksplicit transitøjeblik som lokalt klokkeslæt i den angivne tidszone, uden Z eller UTC-forskydning. MCP kræver det, så et nyt forsøg med nøgle vedrører samme øjeblik. Tidspunktet må ligge i fremtiden. |
timezone | streng | Nej | IANA-tidszone for transitøjeblikket. |
natalChart | objekt | Nej | Valgfri bodygraphfødselsinput med birthDateTime og timezone. birthDateTime er et lokalt klokkeslæt uden Z eller UTC-forskydning. Feltnavnet er en del af backendkontrakten. |
idempotencyKey | streng | Ja | Stabil nøgle til denne tilsigtede transitberegning. Genbrug den kun med identiske argumenter ved nye forsøg. |
Fødselsklokkeslæt er lokale klokkeslæt. Send fødselsdato og -klokkeslæt, præcis som uret viste det på personens fødested, uden Z eller UTC-forskydning, og angiv tidszonen separat som en IANA-identifikator. "birthDateTime": "1990-05-15T14:30:00" med "timezone": "America/New_York" betyder halv tre om eftermiddagen i New York.
Forældet: Værdier, der slutter med Z eller en numerisk forskydning, er forældede. MCP videresender dem, og API’et accepterer dem stadig foreløbigt som UTC og beregner ud fra det. Udfasningen oplyses i API-svaret. De accepteres ikke længere; datoen annonceres på forhånd. Læs hele reglen.
Anmodning
Sanitiseret 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"
}
}
}Format for et vellykket svar
- Planetpositioner for transitter
- Aktiverede gates og kanaler
- Forbindelser til de angivne bodygraphdata
Svaret indeholder også metadata om niveau og kvote fra API’ets adgangslag. De præcise domænefelter varierer efter værktøj og det ønskede detaljeringsniveau.
Fejl
- Startup-niveau kræves
- Ugyldige bodygraphdata
- Ugyldig transitdato
- Kvote overskredet
Kvoteadfærd
Når inputvalidering, godkendelse og niveaukontrol er bestået, bruger et forsøg, der når beregningsudbyderen, præcis én delt API-enhed—selv hvis et efterfølgende præsentationstrin mislykkes. Forkert eller tvetydigt input, afviste niveauer, ukendte referencer og andre fejl før udbyderen bruger nul. Se aktuelt forbrug på my.humandesign.ai.