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

Обнаружение йоги

Обнаружение йоги

POST/api/v2/vedic/yogas

Оцените каталог классической йоги V2 с активными и неактивными правилами, градацией силы, доказательствами, сводными сводками и контекстом Sade Sati.

Аутентификация: отправьте x-api-key.

Полный URL-адрес

https://api.freeastroapi.com/api/v2/vedic/yogas
Безопасные повторы с Idempotency-Key

Аутентифицированные платные astrology POST-запросы принимают необязательный заголовок Idempotency-Key: <уникальный ключ операции, созданный клиентом>. Повторно используйте тот же ключ только при повторе точно того же method, path, query string и JSON body после timeout или сетевой ошибки.

Завершенный повтор возвращает первый ответ с Idempotency-Replayed: true, не запускает расчет заново и не расходует дополнительную квоту. Ключи хранятся примерно 24 часа.

Повторное использование ключа с измененным запросом возвращает 409 idempotency_key_reused. Дубликат, пока первый запрос еще выполняется, возвращает 409 request_in_progress с Retry-After.

Что он возвращает

Оцененный каталог поддерживаемых классических йог и дош. Каждый ряд йоги включает в себя стабильный идентификатор, имя, тип, категорию, активное состояние, силу при активности, задействованные планеты, дома и структурированные доказательства.

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

curl -X POST "https://api.freeastroapi.com/api/v2/vedic/yogas" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "year": 1997,
  "month": 9,
  "day": 22,
  "hour": 23,
  "minute": 25,
  "city": "Mumbai",
  "lat": 19.391928,
  "lng": 72.839732,
  "tz_str": "Asia/Kolkata",
  "ayanamsha": "lahiri",
  "house_system": "whole_sign",
  "node_type": "mean"
}'

Параметры запроса

Передайте city либо оба поля — lat и lng. Для стабильных результатов в production рекомендуется использовать координаты.

Field
year
Type
integer
Required
Yes
Description
Год рождения.
Field
month
Type
integer
Required
Yes
Description
Месяц рождения (1-12).
Field
day
Type
integer
Required
Yes
Description
День рождения.
Field
hour
Type
integer
Required
Yes
Description
Час рождения (0-23).
Field
minute
Type
integer
Required
Yes
Description
Минута рождения (0-59).
Field
city
Type
string
Required
No
Description
Город рождения. Необязательно, если имеется lat/lng.
Field
lat
Type
float
Required
No
Description
Широта рождения. Рекомендуется для production-использования.
Field
lng
Type
float
Required
No
Description
Долгота рождения. Рекомендуется для production-использования.
Field
tz_str
Type
string
Required
No
Description
Необязательное переопределение часового пояса, например Asia/Kolkata, Europe/London, AUTO или LMT. По умолчанию используется AUTO, если опущено.
Field
ayanamsha
Type
string
Required
No
Description
Ведическая айанамша. По умолчанию — lahiri.
Field
house_system
Type
string
Required
No
Description
Система домов. По умолчанию — whole_sign.
Field
node_type
Type
string
Required
No
Description
Тип лунного узла: mean или true.

Форма ответа

Field
yogas
Type
array
Required
n/a
Description
Оцененный каталог активной и неактивной йоги с доказательствами и силой.
Field
sade_sati
Type
object
Required
n/a
Description
Контекст Sade Sati верхнего уровня.
Field
summary
Type
object
Required
n/a
Description
Подсчет ведется по активному состоянию, категории и типу.
Field
metadata
Type
object
Required
n/a
Description
Версия конечной точки, набор правил, настройки вычислений и оцененные идентификаторы правил.

Пример реального запроса

Этот запрос был получен из конечной точки реального производства и представляет собой ту же полезную нагрузку, которая используется во вкладках кода.

{
  "year": 1997,
  "month": 9,
  "day": 22,
  "hour": 23,
  "minute": 25,
  "city": "Mumbai",
  "lat": 19.391928,
  "lng": 72.839732,
  "tz_str": "Asia/Kolkata",
  "ayanamsha": "lahiri",
  "house_system": "whole_sign",
  "node_type": "mean"
}

Пример реального ответа

Это реальный производственный ответ на пример полезной нагрузки. Большие массивы намеренно отображаются так, как их возвращает API.

V2
{
  "yogas": [
    {
      "id": "manglik_dosha",
      "name": "Manglik Dosha",
      "type": "dosha",
      "category": "Affliction",
      "active": true,
      "description": "Mars in 1st, 4th, 7th, 8th, or 12th from Lagna or Moon.",
      "planets": [
        "Mars",
        "Moon"
      ],
      "houses_involved": [
        7
      ],
      "strength": "Strong",
      "evidence": [
        {
          "kind": "house_relation",
          "message": "Mars is 7 from Lagna."
        },
        {
          "kind": "house_relation",
          "message": "Mars is 7 from Moon."
        }
      ]
    },
    {
      "id": "kala_sarpa_yoga",
      "name": "Kala Sarpa Yoga",
      "type": "dosha",
      "category": "Affliction",
      "active": false,
      "description": "All seven classical planets contained within one nodal arc between Rahu and Ketu.",
      "planets": [
        "Sun",
        "Moon",
        "Mars",
        "Mercury",
        "Jupiter",
        "Venus",
        "Saturn",
        "Rahu",
        "Ketu"
      ],
      "houses_involved": [
        4,
        10
      ],
      "strength": null,
      "evidence": [
        {
          "kind": "missing_condition",
          "message": "Classical planets are split across both nodal arcs."
        }
      ]
    },
    {
      "id": "gajakesari_yoga",
      "name": "Gajakesari Yoga",
      "type": "auspicious",
      "category": "Grace & Reputation",
      "active": false,
      "description": "Jupiter in a kendra from the Moon.",
      "planets": [
        "Moon",
        "Jupiter"
      ],
      "houses_involved": [
        1,
        9
      ],
      "strength": null,
      "evidence": [
        {
          "kind": "missing_condition",
          "message": "Jupiter is not in a kendra from the Moon."
        }
      ]
    },
    {
      "id": "budha_aditya_yoga",
      "name": "Budha-Aditya Yoga",
      "type": "auspicious",
      "category": "Intellect",
      "active": false,
      "description": "Sun and Mercury occupy the same sign.",
      "planets": [
        "Sun",
        "Mercury"
      ],
      "houses_involved": [
        4,
        5
      ],
      "strength": null,
      "evidence": [
        {
          "kind": "missing_condition",
          "message": "Sun and Mercury are not in the same sign."
        }
      ]
    },
    {
      "id": "chandra_mangala_yoga",
      "name": "Chandra-Mangala Yoga",
      "type": "dhana_yoga",
      "category": "Wealth",
      "active": true,
      "description": "Moon and Mars are in conjunction or mutual 7th-sign aspect.",
      "planets": [
        "Moon",
        "Mars"
      ],
      "houses_involved": [
        1,
        7
      ],
      "strength": "Medium",
      "evidence": [
        {
          "kind": "mutual_aspect",
          "message": "Moon and Mars are in mutual 7th-sign aspect."
        },
        {
          "kind": "weakening_flag",
          "message": "Moon is afflicted by a classical malefic."
        }
      ]
    },
    {
      "id": "adhi_yoga",
      "name": "Adhi Yoga",
      "type": "raj_yoga",
      "category": "Power",
      "active": true,
      "description": "Benefics occupy the 6th, 7th, or 8th from the Moon.",
      "planets": [
        "Moon",
        "Venus"
      ],
      "houses_involved": [
        1,
        6
      ],
      "strength": "Strong",
      "evidence": [
        {
          "kind": "house_relation",
          "message": "Venus is 6 from the Moon."
        }
      ]
    },
    {
      "id": "saraswati_yoga",
      "name": "Saraswati Yoga",
      "type": "auspicious",
      "category": "Learning",
      "active": false,
      "description": "Mercury, Jupiter, and Venus are well placed from Lagna or Moon, with Jupiter dignified.",
      "planets": [
        "Mercury",
        "Jupiter",
        "Venus"
      ],
      "houses_involved": [
        4,
        6,
        9
      ],
      "strength": null,
      "evidence": [
        {
          "kind": "missing_condition",
          "message": "Mercury, Jupiter, and Venus are not all well placed from Lagna or Moon with Jupiter dignified."
        }
      ]
    },
    {
      "id": "lakshmi_yoga",
      "name": "Lakshmi Yoga",
      "type": "dhana_yoga",
      "category": "Fortune",
      "active": false,
      "description": "A strong 9th lord is related to a strong Lagna lord, or the 10th and 11th lords conjoin in the AstroSage article variant.",
      "planets": [
        "Jupiter",
        "Saturn",
        "Venus"
      ],
      "houses_involved": [
        1,
        9,
        10,
        11
      ],
      "strength": null,
      "evidence": [
        {
          "kind": "strong_lord",
          "message": "Lagna lord Venus is strong in Libra."
        },
        {
          "kind": "missing_condition",
          "message": "The Lagna/9th lord rule is absent and the 10th/11th lords are not conjoined."
        }
      ]
    },
    {
      "id": "ruchaka_yoga",
      "name": "Ruchaka Yoga",
      "type": "raj_yoga",
      "category": "Panch Mahapurusha",
      "active": true,
      "description": "Mars in own or exalted sign in a kendra from Lagna.",
      "planets": [
        "Mars"
      ],
      "houses_involved": [
        7
      ],
      "strength": "Strong",
      "evidence": [
        {
          "kind": "dignity",
          "message": "Mars is own in Scorpio."
        },
        {
          "kind": "house_relation",
          "message": "Mars is in kendra house 7."
        }
      ]
    },
    {
      "id": "bhadra_yoga",
      "name": "Bhadra Yoga",
      "type": "raj_yoga",
      "category": "Panch Mahapurusha",
      "active": false,
      "description": "Mercury in own or exalted sign in a kendra from Lagna.",
      "planets": [
        "Mercury"
      ],
      "houses_involved": [
        4
      ],
      "strength": null,
      "evidence": [
        {
          "kind": "missing_condition",
          "message": "Mercury is not in own/exalted sign in a kendra from Lagna."
        }
      ]
    },
    {
      "id": "hamsa_yoga",
      "name": "Hamsa Yoga",
      "type": "raj_yoga",
      "category": "Panch Mahapurusha",
      "active": false,
      "description": "Jupiter in own or exalted sign in a kendra from Lagna.",
      "planets": [
        "Jupiter"
      ],
      "houses_involved": [
        9
      ],
      "strength": null,
      "evidence": [
        {
          "kind": "missing_condition",
          "message": "Jupiter is not in own/exalted sign in a kendra from Lagna."
        }
      ]
    },
    {
      "id": "malavya_yoga",
      "name": "Malavya Yoga",
      "type": "raj_yoga",
      "category": "Panch Mahapurusha",
      "active": false,
      "description": "Venus in own or exalted sign in a kendra from Lagna.",
      "planets": [
        "Venus"
      ],
      "houses_involved": [
        6
      ],
      "strength": null,
      "evidence": [
        {
          "kind": "missing_condition",
          "message": "Venus is not in own/exalted sign in a kendra from Lagna."
        }
      ]
    },
    {
      "id": "sasa_yoga",
      "name": "Sasa Yoga",
      "type": "raj_yoga",
      "category": "Panch Mahapurusha",
      "active": false,
      "description": "Saturn in own or exalted sign in a kendra from Lagna.",
      "planets": [
        "Saturn"
      ],
      "houses_involved": [
        11
      ],
      "strength": null,
      "evidence": [
        {
          "kind": "missing_condition",
          "message": "Saturn is not in own/exalted sign in a kendra from Lagna."
        }
      ]
    },
    {
      "id": "raj_yoga",
      "name": "Raj Yoga",
      "type": "raj_yoga",
      "category": "Power",
      "active": true,
      "description": "A kendra lord and trikona lord are related by conjunction, Vedic aspect, or exchange.",
      "planets": [
        "Mercury",
        "Saturn",
        "Sun"
      ],
      "houses_involved": [
        4,
        5,
        9
      ],
      "strength": "Medium",
      "evidence": [
        {
          "kind": "exchange",
          "message": "4th lord Sun and 5th lord Mercury: Sun and Mercury are in sign exchange."
        },
        {
          "kind": "vedic_aspect",
          "message": "4th lord Sun and 9th lord Saturn: Sun casts a Vedic aspect on Saturn."
        },
        {
          "kind": "vedic_aspect",
          "message": "4th lord Sun and 9th lord Saturn: Saturn casts a Vedic aspect on Sun."
        },
        {
          "kind": "weakening_flag",
          "message": "Mercury is afflicted by a classical malefic."
        }
      ]
    },
    {
      "id": "dharma_karmadhipati_yoga",
      "name": "Dharma-Karmadhipati Yoga",
      "type": "raj_yoga",
      "category": "Power",
      "active": false,
      "description": "The 9th and 10th lords are related by conjunction, Vedic aspect, or exchange.",
      "planets": [
        "Saturn"
      ],
      "houses_involved": [
        9,
        10
      ],
      "strength": null,
      "evidence": [
        {
          "kind": "missing_condition",
          "message": "The 9th and 10th lords are not related."
        }
      ]
    },
    {
      "id": "dhana_yoga",
      "name": "Dhana Yoga",
      "type": "dhana_yoga",
      "category": "Wealth",
      "active": true,
      "description": "Wealth lords are related to trinal lords, or the 2nd/11th lord strengthens the other core wealth house.",
      "planets": [
        "Jupiter",
        "Saturn"
      ],
      "houses_involved": [
        9,
        11
      ],
      "strength": "Weak",
      "evidence": [
        {
          "kind": "exchange",
          "message": "11th lord Jupiter and 9th lord Saturn: Jupiter and Saturn are in sign exchange."
        },
        {
          "kind": "weakening_flag",
          "message": "Jupiter is debilitated in Capricorn."
        },
        {
          "kind": "weakening_flag",
          "message": "Saturn is afflicted by a classical malefic."
        }
      ]
    },
    {
      "id": "vipareeta_raj_yoga",
      "name": "Vipareeta Raj Yoga",
      "type": "raj_yoga",
      "category": "Power",
      "active": false,
      "description": "The 6th, 8th, or 12th lord is placed in another dusthana.",
      "planets": [],
      "houses_involved": [
        6,
        8,
        12
      ],
      "strength": null,
      "evidence": [
        {
          "kind": "missing_condition",
          "message": "No dusthana lord is placed in another dusthana."
        }
      ]
    },
    {
      "id": "neecha_bhanga_raja_yoga",
      "name": "Neecha Bhanga Raja Yoga",
      "type": "raj_yoga",
      "category": "Cancellation",
      "active": true,
      "description": "A debilitated planet gains standard debility cancellation.",
      "planets": [
        "Jupiter"
      ],
      "houses_involved": [
        9
      ],
      "strength": "Medium",
      "evidence": [
        {
          "kind": "debility_cancellation",
          "message": "Debilitated Jupiter is related to its sign lord Saturn."
        },
        {
          "kind": "debility_cancellation",
          "message": "Debilitated Jupiter is related to its exaltation-sign lord Moon."
        },
        {
          "kind": "weakening_flag",
          "message": "Jupiter is debilitated in Capricorn."
        }
      ]
    }
  ],
  "sade_sati": {
    "active": false,
    "phase": null,
    "description": "Sade Sati not active"
  },
  "summary": {
    "total_evaluated": 18,
    "active": 7,
    "inactive": 11,
    "by_category": {
      "Affliction": {
        "total": 2,
        "active": 1,
        "inactive": 1
      },
      "Grace & Reputation": {
        "total": 1,
        "active": 0,
        "inactive": 1
      },
      "Intellect": {
        "total": 1,
        "active": 0,
        "inactive": 1
      },
      "Wealth": {
        "total": 2,
        "active": 2,
        "inactive": 0
      },
      "Power": {
        "total": 4,
        "active": 2,
        "inactive": 2
      },
      "Learning": {
        "total": 1,
        "active": 0,
        "inactive": 1
      },
      "Fortune": {
        "total": 1,
        "active": 0,
        "inactive": 1
      },
      "Panch Mahapurusha": {
        "total": 5,
        "active": 1,
        "inactive": 4
      },
      "Cancellation": {
        "total": 1,
        "active": 1,
        "inactive": 0
      }
    },
    "by_type": {
      "dosha": {
        "total": 2,
        "active": 1,
        "inactive": 1
      },
      "auspicious": {
        "total": 3,
        "active": 0,
        "inactive": 3
      },
      "dhana_yoga": {
        "total": 3,
        "active": 2,
        "inactive": 1
      },
      "raj_yoga": {
        "total": 10,
        "active": 4,
        "inactive": 6
      }
    }
  },
  "metadata": {
    "endpoint_version": "v2",
    "ruleset_version": "classical_v1",
    "ayanamsha": "lahiri",
    "house_system": "whole_sign",
    "node_type": "mean",
    "timezone_used": "Asia/Kolkata",
    "evaluated_rule_ids": [
      "manglik_dosha",
      "kala_sarpa_yoga",
      "gajakesari_yoga",
      "budha_aditya_yoga",
      "chandra_mangala_yoga",
      "adhi_yoga",
      "saraswati_yoga",
      "lakshmi_yoga",
      "ruchaka_yoga",
      "bhadra_yoga",
      "hamsa_yoga",
      "malavya_yoga",
      "sasa_yoga",
      "raj_yoga",
      "dharma_karmadhipati_yoga",
      "dhana_yoga",
      "vipareeta_raj_yoga",
      "neecha_bhanga_raja_yoga"
    ]
  }
}

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