Transits

Calculez les transits planétaires et leurs aspects par rapport à un thème natal sur une période de temps spécifiée.

Calculer des Transits

Calculez les transits pour une plage de dates :

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-01-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

Paramètres

Paramètre	Type	Requis	Description
birthDate	string	Oui	Date/heure de naissance au format YYYY-MM-DDTHH:mm
birthLocation	object	Oui	Lieu de naissance avec latitude, longitude et fuseau horaire
transitDateStart	string	Oui	Début de la période de transit au format YYYY-MM-DDTHH:mm
transitDateEnd	string	Oui	Fin de la période de transit au format YYYY-MM-DDTHH:mm
transitLocation	object	Oui	Lieu de transit avec latitude, longitude et fuseau horaire
houseSystem	string	Non	Système de maisons (défaut : "placidus")
points	array	Non	Points célestes à calculer
orbs	object	Non	Valeurs d'orbe personnalisées par type d'aspect
language	string	Non	Code de langue pour le contenu textuel (défaut : "en")
includeText	boolean	Non	Inclure le texte d'interprétation (défaut : false)
includeReadableEntities	boolean	Non	Inclure les titres d'entités lisibles par l'humain (défaut : false)

Objet de Localisation

{
  "latitude": 51.5074,
  "longitude": -0.1278,
  "timezone": "Europe/London"
}

Réponse

La réponse inclut les passages de transit (quand les planètes entrent/sortent des signes ou maisons), les positions de maisons de transit, les aspects entre les planètes de transit et natales, et les URLs des thèmes.

{
  "data": {
    "crossings": [...],
    "transitHouses": [...],
    "aspects": [
      {
        "point1": "saturn",
        "point2": "sun",
        "aspect": "conjunction",
        "orb": 1.2,
        "applying": true
      }
    ],
    "charts": {
      "transit": {
        "title": "Transit Chart (Bi-wheel)",
        "url": "..."
      },
      "natal": {
        "title": "Natal Chart",
        "url": "..."
      }
    },
    "natalPoints": [...],
    "natalHouses": [...],
    "transitPoints": [...]
  }
}

Orbes Personnalisés

Spécifiez des valeurs d'orbe personnalisées pour différents types d'aspects :

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-01-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "orbs": {
      "conjunction": 3,
      "opposition": 3,
      "trine": 2,
      "square": 2
    }
  }'

Avec Texte d'Interprétation

Incluez le texte d'interprétation avec vos calculs de transits :

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-15T00:00",
    "transitDateEnd": "2024-01-15T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "includeText": true,
    "language": "en"
  }'

Export iCal

Exportez les événements de transit sous forme de fichier iCal (.ics) pouvant être importé dans des applications de calendrier comme Google Agenda, Apple Calendar ou Outlook.

POST /api/calc/transit/ical

curl -X POST "https://api.astroapi.cloud/api/calc/transit/ical" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-03-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }' --output transits.ics

La réponse est un fichier text/calendar avec Content-Disposition: attachment; filename="transits.ics".

Paramètres

L'export iCal accepte les mêmes paramètres que l'endpoint de transit standard, plus :

Paramètre	Type	Requis	Description
aspects	array	Non	Filtrer par types d'aspects (ex. ["conjunction", "trine"])

TIP

Importez le fichier .ics téléchargé dans votre application de calendrier pour voir les événements de transit sous forme d'entrées de calendrier avec des descriptions de chaque aspect.