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

Планетарная сила

Планетарная сила

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 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
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"
  }
}

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