Ведическая натальная карта (Джйотиш)

POST/api/v2/vedic/chart

Рассчитайте сидерическую карту рождения D1 (Раши) по дате, времени и месту рождения. API возвращает Лагну, положения грах, дома, накшатры и данные для анализа Саде-сати.

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

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

https://api.freeastroapi.com/api/v2/vedic/chart

Безопасные повторы с 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.

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

Структурированный ответ для приложения: Лагна, положения планет, дома, накшатры, контекст Саде-сати и metadata с выбранной айанамшей, системой домов, типом лунных узлов, часовым поясом и версией правил расчета.

Что такое ведическая натальная карта

Ведическая натальная карта — это сидерическая карта рождения в традиции Джйотиш. Ее также ищут как карту Раши, Кундли или индийский гороскоп. Основная карта D1 показывает Лагну, знаки и дома планет, накшатры и другие исходные данные для дальнейшего астрологического анализа.

Если приложению нужен полный набор ведических расчетов, включая варги, даши, йоги и Панчанг, используйте полный ведический расчет. Для готовой SVG- или PNG-карты перейдите к документации по визуальной ведической карте.

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

curl -X POST "https://api.freeastroapi.com/api/v2/vedic/chart" \
 -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 рекомендуется использовать координаты.

Поле

year

Тип

integer

Обязательно

Да

Описание

Год рождения.

Поле

month

Тип

integer

Обязательно

Да

Описание

Месяц рождения (1-12).

Поле

day

Тип

integer

Обязательно

Да

Описание

День рождения.

Поле

hour

Тип

integer

Обязательно

Да

Описание

Час рождения (0-23).

Поле

minute

Тип

integer

Обязательно

Да

Описание

Минута рождения (0-59).

Поле

city

Тип

string

Обязательно

Нет

Описание

Город рождения. Необязательно, если имеется lat/lng.

Поле

lat

Тип

float

Обязательно

Нет

Описание

Широта рождения. Рекомендуется для production-использования.

Поле

lng

Тип

float

Обязательно

Нет

Описание

Долгота рождения. Рекомендуется для production-использования.

Поле

tz_str

Тип

string

Обязательно

Нет

Описание

Необязательное переопределение часового пояса, например Asia/Kolkata, Europe/London, AUTO или LMT. По умолчанию используется AUTO, если опущено.

Поле

ayanamsha

Тип

string

Обязательно

Нет

Описание

Ведическая айанамша. По умолчанию — lahiri.

Поле

house_system

Тип

string

Обязательно

Нет

Описание

Система домов. По умолчанию — whole_sign.

Поле

node_type

Тип

string

Обязательно

Нет

Описание

Тип лунного узла: mean или true.

Поле

include_avastha

Тип

boolean

Обязательно

Нет

Описание

Включите возраст планеты Baladi Avastha на каждой планете.

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

Форма ответа

Поле

ascendant

Тип

object

Обязательно

Не применимо

Описание

Сидерический знак ascendant, градус и контекст Nakshatra.

Поле

planets

Тип

array

Обязательно

Не применимо

Описание

Позиции Грахи со знаком, домом, Nakshatra, падой, ретроградным состоянием и абсолютным градусом.

Поле

planets[].avastha

Тип

object

Обязательно

Не применимо

Описание

Необязательное состояние возраста Baladi Avastha, если include_avastha — true.

Поле

houses

Тип

array

Обязательно

Не применимо

Описание

Сопоставление house/sign для выбранной системы домов.

Поле

sade_sati

Тип

object

Обязательно

Не применимо

Описание

Текущий статус Sade Sati вычисляется из контекста диаграммы.

Поле

metadata

Тип

object

Обязательно

Не применимо

Описание

Версия конечной точки, версия набора правил, аянамша, домашняя система, тип узла и используемый часовой пояс.

Поле	Тип	Обязательно	Описание
ascendant	object	Не применимо	Сидерический знак ascendant, градус и контекст Nakshatra.
planets	array	Не применимо	Позиции Грахи со знаком, домом, Nakshatra, падой, ретроградным состоянием и абсолютным градусом.
planets[].avastha	object	Не применимо	Необязательное состояние возраста Baladi Avastha, если include_avastha — true.
houses	array	Не применимо	Сопоставление house/sign для выбранной системы домов.
sade_sati	object	Не применимо	Текущий статус Sade Sati вычисляется из контекста диаграммы.
metadata	object	Не применимо	Версия конечной точки, версия набора правил, аянамша, домашняя система, тип узла и используемый часовой пояс.

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

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

{
  "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.

{
  "ascendant": {
    "degree": 58.7441,
    "sign": "Taurus",
    "sign_id": 2,
    "nakshatra": {
      "id": 5,
      "name": "Mrigashira",
      "pada": 2,
      "lord": "Mars"
    }
  },
  "planets": [
    {
      "name": "Sun",
      "absolute_degree": 155.9362,
      "sign": "Virgo",
      "sign_id": 6,
      "degree_in_sign": 5.9362,
      "house": 5,
      "is_retrograde": false,
      "nakshatra": "Uttara Phalguni",
      "nakshatra_id": 12,
      "pada": 3,
      "nakshatra_lord": "Sun"
    },
    {
      "name": "Moon",
      "absolute_degree": 56.0529,
      "sign": "Taurus",
      "sign_id": 2,
      "degree_in_sign": 26.0529,
      "house": 1,
      "is_retrograde": false,
      "nakshatra": "Mrigashira",
      "nakshatra_id": 5,
      "pada": 1,
      "nakshatra_lord": "Mars"
    },
    {
      "name": "Mars",
      "absolute_degree": 211.8965,
      "sign": "Scorpio",
      "sign_id": 8,
      "degree_in_sign": 1.8965,
      "house": 7,
      "is_retrograde": false,
      "nakshatra": "Vishakha",
      "nakshatra_id": 16,
      "pada": 4,
      "nakshatra_lord": "Jupiter"
    },
    {
      "name": "Mercury",
      "absolute_degree": 139.8928,
      "sign": "Leo",
      "sign_id": 5,
      "degree_in_sign": 19.8928,
      "house": 4,
      "is_retrograde": false,
      "nakshatra": "Purva Phalguni",
      "nakshatra_id": 11,
      "pada": 2,
      "nakshatra_lord": "Venus"
    },
    {
      "name": "Jupiter",
      "absolute_degree": 288.6611,
      "sign": "Capricorn",
      "sign_id": 10,
      "degree_in_sign": 18.6611,
      "house": 9,
      "is_retrograde": true,
      "nakshatra": "Shravana",
      "nakshatra_id": 22,
      "pada": 3,
      "nakshatra_lord": "Moon"
    },
    {
      "name": "Venus",
      "absolute_degree": 198.4909,
      "sign": "Libra",
      "sign_id": 7,
      "degree_in_sign": 18.4909,
      "house": 6,
      "is_retrograde": false,
      "nakshatra": "Swati",
      "nakshatra_id": 15,
      "pada": 4,
      "nakshatra_lord": "Rahu"
    },
    {
      "name": "Saturn",
      "absolute_degree": 354.4198,
      "sign": "Pisces",
      "sign_id": 12,
      "degree_in_sign": 24.4198,
      "house": 11,
      "is_retrograde": true,
      "nakshatra": "Revati",
      "nakshatra_id": 27,
      "pada": 3,
      "nakshatra_lord": "Mercury"
    },
    {
      "name": "Rahu",
      "absolute_degree": 145.2107,
      "sign": "Leo",
      "sign_id": 5,
      "degree_in_sign": 25.2107,
      "house": 4,
      "is_retrograde": true,
      "nakshatra": "Purva Phalguni",
      "nakshatra_id": 11,
      "pada": 4,
      "nakshatra_lord": "Venus"
    },
    {
      "name": "Ketu",
      "absolute_degree": 325.2107,
      "sign": "Aquarius",
      "sign_id": 11,
      "degree_in_sign": 25.2107,
      "house": 10,
      "is_retrograde": true,
      "nakshatra": "Purva Bhadrapada",
      "nakshatra_id": 25,
      "pada": 2,
      "nakshatra_lord": "Jupiter"
    }
  ],
  "houses": [
    {
      "house": 1,
      "sign": "Taurus",
      "sign_id": 2,
      "degree_cusp": 0
    },
    {
      "house": 2,
      "sign": "Gemini",
      "sign_id": 3,
      "degree_cusp": 0
    },
    {
      "house": 3,
      "sign": "Cancer",
      "sign_id": 4,
      "degree_cusp": 0
    },
    {
      "house": 4,
      "sign": "Leo",
      "sign_id": 5,
      "degree_cusp": 0
    },
    {
      "house": 5,
      "sign": "Virgo",
      "sign_id": 6,
      "degree_cusp": 0
    },
    {
      "house": 6,
      "sign": "Libra",
      "sign_id": 7,
      "degree_cusp": 0
    },
    {
      "house": 7,
      "sign": "Scorpio",
      "sign_id": 8,
      "degree_cusp": 0
    },
    {
      "house": 8,
      "sign": "Sagittarius",
      "sign_id": 9,
      "degree_cusp": 0
    },
    {
      "house": 9,
      "sign": "Capricorn",
      "sign_id": 10,
      "degree_cusp": 0
    },
    {
      "house": 10,
      "sign": "Aquarius",
      "sign_id": 11,
      "degree_cusp": 0
    },
    {
      "house": 11,
      "sign": "Pisces",
      "sign_id": 12,
      "degree_cusp": 0
    },
    {
      "house": 12,
      "sign": "Aries",
      "sign_id": 1,
      "degree_cusp": 0
    }
  ],
  "sade_sati": {
    "active": false,
    "phase": null,
    "description": "Sade Sati not active"
  },
  "metadata": {
    "endpoint_version": "v2",
    "ruleset_version": "classical_chart_v1",
    "ayanamsha": "lahiri",
    "house_system": "whole_sign",
    "node_type": "mean",
    "timezone_used": "Asia/Kolkata"
  }
}

FAQ

Как рассчитать ведическую натальную карту (Джйотиш) через API?

Передайте год, месяц, день, час и минуту рождения, а также city или координаты lat и lng. При необходимости укажите tz_str, ayanamsha, house_system и node_type. Отправьте запрос POST на /api/v2/vedic/chart с ключом x-api-key.

API строит карту D1 (Раши), Кундли или дробные карты?

Эта конечная точка возвращает основную сидерическую карту D1, которую также называют картой Раши, ведической картой рождения или Кундли. Для дробных карт D9, D10 и других варг используйте документацию по варгам.

Может ли API ведической карты вернуть возрастное состояние планеты — Авастху?

Да. Установите include_avastha в true, чтобы добавить planets[].avastha с состоянием Балади-авастха для каждой возвращенной грахи. По умолчанию поле не включается для обратной совместимости.

Возвращает ли API Шадбалу или Ишта/Кашта-пхалу?

Нет. Для расчета Шадбалы используйте конечную точку ведической силы. Ишта/Кашта-пхала в настоящее время не возвращается API.

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

API ведической астрологии Полный ведический расчет Визуальная ведическая карта Дробные карты (варги)Панчанг