Поле
year
Тип
integer
Обязательно
Да
Описание
Год рождения.
Назад к документации
Планетарная сила
Планетарная сила
POST
/api/v2/vedic/strengthРассчитайте калиброванные показатели силы V2, Shadbala и Ashtakavarga для семи классических грах.
Аутентификация: отправьте x-api-key.
Полный URL-адрес
https://api.freeastroapi.com/api/v2/vedic/strengthБезопасные повторы с 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.
Что он возвращает
Полезная нагрузка производственной мощности со строками компонентов Shadbala, общими значениями Shadbala, Сарваштакаваргой, Бхиннаштакаваргой, Прастхараштакаваргой и метаданными, описывающими используемые механизмы прочности.
Пример запроса
curl -X POST "https://api.freeastroapi.com/api/v2/vedic/strength" \
-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 рекомендуется использовать координаты.
Поле
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.
Форма ответа
Поле
shadbala
Тип
object
Обязательно
Не применимо
Описание
Строки и итоги компонентов Shadbala по планетам.
Поле
ashtakavarga.sarvashtakavarga
Тип
array[number]
Обязательно
Не применимо
Описание
Баллы Sarvashtakavarga по sign/house.
Поле
ashtakavarga.bhinnashtakavarga
Тип
object
Обязательно
Не применимо
Описание
Строки баллов Bhinnashtakavarga по планетам.
Поле
ashtakavarga.prastharashtakavarga
Тип
object
Обязательно
Не применимо
Описание
Подробная матрица вклада баллов.
Поле
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.
V2
{
"shadbala": {
"Sun": {
"sthana_bala": 170.74,
"dig_bala": 5.98,
"kala_bala": 122.67,
"cheshta_bala": 30.08,
"naisargika_bala": 60,
"drik_bala": 13.35,
"total": 402.82,
"shadbala_in_rupas": 6.71,
"minimum_requirements": 5,
"ratio": 1.34
},
"Moon": {
"sthana_bala": 198.57,
"dig_bala": 32.69,
"kala_bala": 141.72,
"cheshta_bala": 33.29,
"naisargika_bala": 51.42,
"drik_bala": -5.94,
"total": 451.75,
"shadbala_in_rupas": 7.53,
"minimum_requirements": 6,
"ratio": 1.26
},
"Mars": {
"sthana_bala": 256.3,
"dig_bala": 24.64,
"kala_bala": 86.6,
"cheshta_bala": 25.2,
"naisargika_bala": 17.16,
"drik_bala": -1.79,
"total": 408.11,
"shadbala_in_rupas": 6.8,
"minimum_requirements": 5,
"ratio": 1.36
},
"Mercury": {
"sthana_bala": 227.88,
"dig_bala": 32.95,
"kala_bala": 131.44,
"cheshta_bala": 25,
"naisargika_bala": 25.74,
"drik_bala": 18.17,
"total": 461.18,
"shadbala_in_rupas": 7.69,
"minimum_requirements": 7,
"ratio": 1.1
},
"Jupiter": {
"sthana_bala": 126.43,
"dig_bala": 16.64,
"kala_bala": 167.31,
"cheshta_bala": 46.08,
"naisargika_bala": 34.26,
"drik_bala": -4.27,
"total": 386.45,
"shadbala_in_rupas": 6.44,
"minimum_requirements": 6.5,
"ratio": 0.99
},
"Venus": {
"sthana_bala": 166.54,
"dig_bala": 39.83,
"kala_bala": 109.25,
"cheshta_bala": 30.8,
"naisargika_bala": 42.84,
"drik_bala": 3.18,
"total": 392.44,
"shadbala_in_rupas": 6.54,
"minimum_requirements": 5.5,
"ratio": 1.19
},
"Saturn": {
"sthana_bala": 177.28,
"dig_bala": 21.44,
"kala_bala": 101.91,
"cheshta_bala": 54.1,
"naisargika_bala": 8.58,
"drik_bala": 4.49,
"total": 367.8,
"shadbala_in_rupas": 6.13,
"minimum_requirements": 5,
"ratio": 1.23
}
},
"ashtakavarga": {
"sarvashtakavarga": [
21,
29,
34,
33,
31,
23,
31,
26,
29,
26,
23,
31
],
"bhinnashtakavarga": {
"Sun": [
5,
4,
5,
5,
2,
5,
5,
3,
4,
2,
3,
5
],
"Moon": [
4,
3,
3,
7,
5,
1,
4,
4,
4,
4,
5,
5
],
"Mars": [
0,
3,
5,
3,
2,
3,
5,
4,
4,
3,
3,
4
],
"Mercury": [
2,
5,
7,
3,
7,
2,
5,
4,
7,
4,
5,
3
],
"Jupiter": [
3,
5,
6,
4,
6,
5,
3,
7,
3,
4,
5,
5
],
"Venus": [
4,
5,
5,
6,
5,
4,
5,
3,
5,
6,
1,
3
],
"Saturn": [
3,
4,
3,
5,
4,
3,
4,
1,
2,
3,
1,
6
]
},
"prastharashtakavarga": {
"Sun": {
"Sun": [
1,
1,
1,
1,
0,
1,
1,
0,
1,
0,
0,
1
],
"Moon": [
0,
0,
0,
1,
0,
0,
1,
0,
0,
0,
1,
1
],
"Mars": [
0,
1,
1,
1,
1,
1,
0,
1,
1,
0,
1,
0
],
"Mercury": [
1,
1,
1,
1,
0,
0,
1,
0,
1,
1,
0,
0
],
"Jupiter": [
0,
1,
1,
0,
0,
1,
0,
1,
0,
0,
0,
0
],
"Venus": [
1,
0,
0,
0,
0,
1,
0,
0,
0,
0,
0,
1
],
"Saturn": [
1,
0,
1,
0,
0,
1,
1,
1,
1,
1,
0,
1
],
"Ascendant": [
1,
0,
0,
1,
1,
0,
1,
0,
0,
0,
1,
1
]
},
"Moon": {
"Sun": [
1,
0,
1,
1,
0,
0,
0,
1,
0,
0,
1,
1
],
"Moon": [
0,
1,
0,
1,
0,
0,
1,
1,
0,
0,
1,
1
],
"Mars": [
1,
0,
0,
1,
1,
1,
0,
0,
1,
1,
0,
1
],
"Mercury": [
0,
1,
1,
0,
1,
0,
1,
1,
1,
0,
1,
1
],
"Jupiter": [
1,
0,
0,
1,
1,
0,
1,
1,
1,
1,
0,
0
],
"Venus": [
1,
0,
1,
1,
1,
0,
0,
0,
1,
1,
1,
0
],
"Saturn": [
0,
1,
0,
1,
1,
0,
0,
0,
0,
1,
0,
0
],
"Ascendant": [
0,
0,
0,
1,
0,
0,
1,
0,
0,
0,
1,
1
]
},
"Mars": {
"Sun": [
0,
0,
1,
1,
0,
0,
0,
1,
0,
1,
1,
0
],
"Moon": [
0,
0,
0,
1,
0,
0,
1,
0,
0,
0,
0,
1
],
"Mars": [
0,
1,
1,
0,
1,
1,
0,
1,
1,
0,
1,
0
],
"Mercury": [
0,
0,
1,
0,
0,
0,
1,
0,
1,
1,
0,
0
],
"Jupiter": [
0,
0,
1,
0,
0,
0,
1,
1,
1,
0,
0,
0
],
"Venus": [
0,
1,
0,
0,
1,
1,
0,
0,
0,
0,
0,
1
],
"Saturn": [
0,
0,
1,
0,
0,
1,
1,
1,
1,
1,
0,
1
],
"Ascendant": [
0,
1,
0,
1,
0,
0,
1,
0,
0,
0,
1,
1
]
},
"Mercury": {
"Sun": [
0,
1,
0,
1,
1,
0,
0,
0,
0,
1,
1,
0
],
"Moon": [
0,
0,
1,
0,
1,
0,
1,
0,
1,
0,
1,
1
],
"Mars": [
0,
1,
1,
1,
1,
1,
0,
1,
1,
0,
1,
0
],
"Mercury": [
1,
1,
1,
1,
1,
0,
1,
0,
1,
1,
0,
0
],
"Jupiter": [
0,
0,
1,
0,
1,
0,
0,
1,
1,
0,
0,
0
],
"Venus": [
0,
1,
1,
0,
1,
0,
1,
1,
1,
1,
1,
0
],
"Saturn": [
1,
0,
1,
0,
0,
1,
1,
1,
1,
1,
0,
1
],
"Ascendant": [
0,
1,
1,
0,
1,
0,
1,
0,
1,
0,
1,
1
]
},
"Jupiter": {
"Sun": [
1,
1,
1,
1,
0,
1,
1,
1,
1,
0,
0,
1
],
"Moon": [
0,
0,
1,
0,
0,
1,
0,
1,
0,
1,
0,
1
],
"Mars": [
0,
1,
1,
0,
1,
1,
0,
1,
1,
0,
1,
0
],
"Mercury": [
1,
1,
1,
0,
1,
1,
0,
1,
1,
1,
0,
0
],
"Jupiter": [
1,
0,
0,
1,
1,
0,
1,
1,
0,
1,
1,
1
],
"Venus": [
0,
0,
1,
1,
1,
0,
0,
1,
0,
0,
1,
1
],
"Saturn": [
0,
1,
0,
1,
1,
0,
0,
0,
0,
0,
1,
0
],
"Ascendant": [
0,
1,
1,
0,
1,
1,
1,
1,
0,
1,
1,
1
]
},
"Venus": {
"Sun": [
1,
0,
0,
1,
1,
0,
0,
0,
0,
0,
0,
0
],
"Moon": [
1,
1,
1,
1,
1,
1,
0,
0,
1,
1,
0,
1
],
"Mars": [
1,
0,
0,
1,
0,
1,
1,
0,
0,
1,
0,
1
],
"Mercury": [
1,
0,
1,
0,
0,
0,
1,
0,
1,
1,
0,
0
],
"Jupiter": [
0,
1,
0,
0,
1,
1,
1,
1,
0,
0,
0,
0
],
"Venus": [
0,
1,
1,
1,
1,
0,
1,
1,
1,
1,
1,
0
],
"Saturn": [
0,
1,
1,
1,
0,
0,
1,
1,
1,
1,
0,
0
],
"Ascendant": [
0,
1,
1,
1,
1,
1,
0,
0,
1,
1,
0,
1
]
},
"Saturn": {
"Sun": [
1,
0,
1,
1,
0,
1,
1,
0,
1,
0,
0,
1
],
"Moon": [
0,
0,
0,
1,
0,
0,
1,
0,
0,
0,
0,
1
],
"Mars": [
1,
0,
0,
0,
1,
1,
1,
0,
0,
1,
0,
1
],
"Mercury": [
1,
1,
1,
1,
0,
0,
0,
0,
0,
1,
0,
1
],
"Jupiter": [
0,
1,
1,
0,
0,
0,
0,
1,
1,
0,
0,
0
],
"Venus": [
0,
0,
0,
0,
1,
1,
0,
0,
0,
0,
0,
1
],
"Saturn": [
0,
1,
0,
1,
1,
0,
0,
0,
0,
1,
0,
0
],
"Ascendant": [
0,
1,
0,
1,
1,
0,
1,
0,
0,
0,
1,
1
]
}
},
"total_points": 337
},
"metadata": {
"endpoint_version": "v2",
"ruleset_version": "classical_strength_v1",
"ayanamsha": "lahiri",
"house_system": "whole_sign",
"node_type": "mean",
"timezone_used": "Asia/Kolkata",
"shadbala_engine": "classical_v1",
"ashtakavarga_engine": "classical_v1",
"dig_bala_basis": "placidus_sidereal"
}
}