Обнаружение йоги
Обнаружение йоги
/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 and lng. Координаты рекомендуются для стабильных результатов производства.
| Field | Type | Required | Description |
|---|---|---|---|
| year | integer | Yes | Год рождения. |
| month | integer | Yes | Месяц рождения (1-12). |
| day | integer | Yes | День рождения. |
| hour | integer | Yes | Час рождения (0-23). |
| minute | integer | Yes | Минута рождения (0-59). |
| city | string | No | Город рождения. Необязательно, если имеется lat/lng. |
| lat | float | No | Широта рождения. Рекомендуется для production-использования. |
| lng | float | No | Долгота рождения. Рекомендуется для production-использования. |
| tz_str | string | No | Необязательное переопределение часового пояса, например Asia/Kolkata, Europe/London, AUTO или LMT. По умолчанию используется AUTO, если опущено. |
| ayanamsha | string | No | Ведическая айанамша. По умолчанию — lahiri. |
| house_system | string | No | Система домов. По умолчанию — whole_sign. |
| node_type | string | No | Тип лунного узла: mean или true. |
Форма ответа
| Field | Type | Required | Description |
|---|---|---|---|
| yogas | array | n/a | Оцененный каталог активной и неактивной йоги с доказательствами и силой. |
| sade_sati | object | n/a | Контекст Sade Sati верхнего уровня. |
| summary | object | n/a | Подсчет ведется по активному состоянию, категории и типу. |
| metadata | object | n/a | Версия конечной точки, набор правил, настройки вычислений и оцененные идентификаторы правил. |
Пример реального запроса
Этот запрос был получен из конечной точки реального производства и представляет собой ту же полезную нагрузку, которая используется во вкладках кода.
{
"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.
{
"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"
]
}
}