Назад к документации

Точный поиск аспектов

Точный поиск аспектов

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

Поиск по точному аспекту возвращает точные совпадения в запрошенном окне даты для progressed-to-natal, progressed-to-progressed или обоих режимов отношений.

Эта конечная точка требует x-api-key. Пример ниже представляет собой полностью аутентифицированный запрос.

Как это работает

Set top_events_only=true при вторичном, третичном, повседневном или четвертичном поиске exact-aspect, чтобы получить тщательно подобранный редакционный список, а не полный хронологический набор результатов.

Короткий список может возвращать меньше событий, если остаются только контакты угла или узла lower-signal.

Поддерживаемые системы

Этот шаблон exact-aspects работает для всех пяти систем. Заменять {system} with secondary, converse-secondary, tertiary, quotidian, или quaternary.

Пример запроса

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"
  }
}'

Реальный пример ответа API

Снято с прямого эфира API 14 апреля 2026 г. по указанному выше запросу.

{
  "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"
    }
  ]
}

Связанные документы