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

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

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

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 and lng. Координаты рекомендуются для стабильных результатов производства.

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

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