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

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

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

Description

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

Field

lat

Type

float

Required

Description

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

Field

lng

Type

float

Required

Description

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

Field

tz_str

Type

string

Required

Description

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

Field

ayanamsha

Type

string

Required

Description

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

Field

house_system

Type

string

Required

Description

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

Field

node_type

Type

string

Required

Description

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

Field

include_avastha

Type

boolean

Required

Description

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

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.
include_avastha	boolean	No	Включите возраст планеты Baladi Avastha на каждой планете.

Форма ответа

Field

ascendant

Type

object

Required

n/a

Description

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

Field

planets

Type

array

Required

n/a

Description

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

Field

planets[].avastha

Type

object

Required

n/a

Description

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

Field

houses

Type

array

Required

n/a

Description

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

Field

sade_sati

Type

object

Required

n/a

Description

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

Field

metadata

Type

object

Required

n/a

Description

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

Field	Type	Required	Description
ascendant	object	n/a	Сидерический знак ascendant, градус и контекст Nakshatra.
planets	array	n/a	Позиции Грахи со знаком, домом, Nakshatra, падой, ретроградным состоянием и абсолютным градусом.
planets[].avastha	object	n/a	Необязательное состояние возраста Baladi Avastha, если include_avastha — true.
houses	array	n/a	Сопоставление house/sign для выбранной системы домов.
sade_sati	object	n/a	Текущий статус Sade Sati вычисляется из контекста диаграммы.
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.

{
  "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 ведической астрологии Полный ведический расчет Визуальная ведическая карта Дробные карты (варги)Панчанг