Retour à la documentation

Recherche d’aspects exacts

Recherche d’aspects exacts

POST/api/v1/western/progressions/{system}/exact-aspects

La recherche d’aspects exacts renvoie les dates des contacts sur la période demandée, entre positions progressées et natales, entre positions progressées, ou selon les deux modes.

Cet endpoint nécessite x-api-key. L’exemple ci-dessous est une requête authentifiée complète.

Fonctionnement

Définissez top_events_only=true pour les recherches d’aspects exacts secondaires, tertiaires, quotidiennes ou quaternaires afin d’obtenir une sélection des événements les plus significatifs plutôt que tous les résultats chronologiques.

La sélection peut contenir moins d’événements lorsqu’il ne reste que des contacts de moindre importance impliquant les angles ou les nœuds.

Systèmes pris en charge

Ce modèle de recherche d’aspects exacts fonctionne pour les cinq systèmes. Remplacez {system} par secondary, converse-secondary, tertiary, quotidianou quaternary.

Exemple de requête

curl -X POST "https://api.freeastroapi.com/api/v1/western/progressions/secondary/exact-aspects" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "natal": {
    "name": "User",
    "datetime": "1990-01-01 12:00",
    "time_known": true,
    "location": {
      "city": "London",
      "lat": 51.5074,
      "lng": -0.1278,
      "tz_str": "AUTO"
    }
  },
  "search": {
    "from": "2026-03-30",
    "to": "2027-03-30"
  }
}'

Exemple de réponse réelle de l’API

Réponse enregistrée depuis l’API en production le 14 avril 2026 avec la requête ci-dessus.

{
  "meta": {
    "endpoint": "exact_aspects",
    "version": "v1",
    "system": "secondary",
    "zodiac_type": "tropical",
    "house_system": "placidus",
    "generated_at": "2026-04-14T15:54:54Z"
  },
  "window": {
    "from": "2026-03-30",
    "to": "2027-03-30",
    "limit": 100,
    "order": "asc"
  },
  "events": [
    {
      "event_date": "2026-03-30T00:00:00Z",
      "relation": "progressed_to_natal",
      "point_1": "mars",
      "point_2": "uranus",
      "aspect": {
        "name": "conjunction",
        "angle_deg": 0
      },
      "target_datetime_utc": "2026-03-30T00:00:00Z",
      "basis": {
        "age_years_decimal": 36.240337,
        "progressed_days_after_birth": 36.240337,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-06T17:46:05Z"
      },
      "interpretation_key": "progressed_mars_conjunction_natal_uranus"
    },
    {
      "event_date": "2026-04-19T22:30:00Z",
      "relation": "progressed_to_progressed",
      "point_1": "pluto",
      "point_2": "sun",
      "aspect": {
        "name": "square",
        "angle_deg": 90
      },
      "target_datetime_utc": "2026-04-19T22:30:00Z",
      "basis": {
        "age_years_decimal": 36.297662,
        "progressed_days_after_birth": 36.297662,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-06T19:08:37Z"
      },
      "interpretation_key": "progressed_pluto_square_progressed_sun"
    },
    {
      "event_date": "2026-05-04T00:00:00Z",
      "relation": "progressed_to_natal",
      "point_1": "moon",
      "point_2": "sun",
      "aspect": {
        "name": "opposition",
        "angle_deg": 180
      },
      "target_datetime_utc": "2026-05-04T00:00:00Z",
      "basis": {
        "age_years_decimal": 36.336164,
        "progressed_days_after_birth": 36.336164,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-06T20:04:04Z"
      },
      "interpretation_key": "progressed_moon_opposition_natal_sun"
    },
    {
      "event_date": "2026-06-08T00:00:00Z",
      "relation": "progressed_to_natal",
      "point_1": "moon",
      "point_2": "neptune",
      "aspect": {
        "name": "opposition",
        "angle_deg": 180
      },
      "target_datetime_utc": "2026-06-08T00:00:00Z",
      "basis": {
        "age_years_decimal": 36.431991,
        "progressed_days_after_birth": 36.431991,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-06T22:22:03Z"
      },
      "interpretation_key": "progressed_moon_opposition_natal_neptune"
    },
    {
      "event_date": "2026-07-13T00:00:00Z",
      "relation": "progressed_to_progressed",
      "point_1": "moon",
      "point_2": "neptune",
      "aspect": {
        "name": "opposition",
        "angle_deg": 180
      },
      "target_datetime_utc": "2026-07-13T00:00:00Z",
      "basis": {
        "age_years_decimal": 36.527817,
        "progressed_days_after_birth": 36.527817,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-07T00:40:03Z"
      },
      "interpretation_key": "progressed_moon_opposition_progressed_neptune"
    },
    {
      "event_date": "2026-09-11T00:00:00Z",
      "relation": "progressed_to_natal",
      "point_1": "moon",
      "point_2": "saturn",
      "aspect": {
        "name": "opposition",
        "angle_deg": 180
      },
      "target_datetime_utc": "2026-09-11T00:00:00Z",
      "basis": {
        "age_years_decimal": 36.692092,
        "progressed_days_after_birth": 36.692092,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-07T04:36:36Z"
      },
      "interpretation_key": "progressed_moon_opposition_natal_saturn"
    }
  ]
}

Documentation associée

Vue d’ensemble des progressionsCalendrier des progressions