Field
year
Type
integer
Required
Yes
Description
Год рождения.
Назад к документации
Планетарная сила
Планетарная сила
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 рекомендуется использовать координаты.
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
shadbala
Type
object
Required
n/a
Description
Строки и итоги компонентов Shadbala по планетам.
Field
ashtakavarga.sarvashtakavarga
Type
array[number]
Required
n/a
Description
Баллы Sarvashtakavarga по sign/house.
Field
ashtakavarga.bhinnashtakavarga
Type
object
Required
n/a
Description
Строки баллов Bhinnashtakavarga по планетам.
Field
ashtakavarga.prastharashtakavarga
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
{
"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"
}
}