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

Основная ведическая карта

Основная ведическая карта

POST/api/v2/vedic/chart

Рассчитайте калиброванную сидерическую карту V2 D1 с асцендентом, расположением грах, домами, Nakshatra и контекстом Sade Sati.

Аутентификация: отправьте 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.

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

Чистая полезная нагрузка диаграммы V2, созданная для производственных приложений: асцендент, планеты, дома, Sade Sati и метаданные, в которых записаны айанамша, система домов, тип узла, часовой пояс и используемый набор правил.

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

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 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
include_avastha
Type
boolean
Required
No
Description
Включите возраст планеты 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
Версия конечной точки, версия набора правил, аянамша, домашняя система, тип узла и используемый часовой пояс.

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

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

{
  "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
{
  "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 вернуть состояние возраста планеты Авастха?

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

Возвращает ли эта конечная точка Shadbala или Ишта/Кашта Пхала?

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

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

Полный ведический расчетДивизионные диаграммы