POST/api/astro/attributes/1 кредит

Атрибуты карты

Двенадцать небольших показателей карты в одном вызове — иначе ради них пришлось бы сделать десяток запросов. Рассчитываются всегда все двенадцать, что бы вы ни передали. В набор входят накшатра и пада для заданной эклиптической долготы, номер накшатры и её управитель по названию, управитель хадды (египетского терма) для долготы внутри знака, управитель какшьи и номер какшьи, знак зодиака для долготы, планеты, сожжённые в заданный момент, фазовый угол Луны, ближайшее наступление выбранной лунной фазы, четыре момента сезонных ингрессий за год и положение в дробной карте, вычисленное по долготе. Обязательно только `date_time`; для всего остального есть значения по умолчанию (долгота 0, название 'Ashwini', знак 'Aries', управитель 'saturn', target_phase 0 для новолуния, limitdays 30, текущий год, chart_factor 1 для карты раши). Поэтому даже минимальный вызов с одними `date_time` и `longitude` уже даёт сожжённые планеты, фазу Луны, накшатру и знак. Две особенности: `lord` сравнивается с учётом регистра с данными, где Mercury записан с заглавной буквы, поэтому 'mercury' молча возвращает null, а 'Mercury' — число; а поля запроса `when` и `nakshatras` принимаются, но не используются.

https://api.occultapi.com/api/astro/attributes/

Попробовать запрос

Аутентификация

Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запроса

Поле	Тип	Обязательно	Примечания
date_time	string (date-time)	обязательный	Момент расчёта в формате ISO 8601. ВСЕГДА указывайте смещение или суффикс Z: значение без часового пояса интерпретируется как Asia/Kolkata (UTC+05:30), а не UTC, и может вернуть результат за предыдущий день со статусом 200. '2026-09-01T06:00:00Z' и '2026-09-01 06:00:00' — разные моменты, и ответы для них будут разными. Ограничение ФОРМАТА, а не перечисление. DRF DateTimeField: только ISO-8601 (входные форматы DRF по умолчанию), например "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" или "2026-09-01 06:00:00" (без часового пояса подразумевается UTC).
chart_factor	integer	необязательный	Множитель дробной карты для dasavarga_from_longitude (1 = раши, 9 = навамша и т. д.).
limitdays	integer	необязательный	Окно поиска в днях для search_moon_phase.
longitude	number (double)	необязательный	Долгота места в десятичных градусах. Положительные значения — восток, отрицательные — запад. Пример: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Следите за знаком: без минуса Нью-Йорк окажется в Китае. min -180 · max 180
lord	string	необязательный	Планета-управитель для get_kakshya_number. `saturnjupitermarssunvenusMercurymoonascendant` Точное совпадение С УЧЁТОМ регистра. Сами данные непоследовательны: семь записей в нижнем регистре, но Mercury хранится с заглавной буквы как 'Mercury', поэтому 'mercury' молча возвращает null, а 'Mercury' — 6. При несовпадении возвращается null без ошибки. По умолчанию 'saturn'.
nakshatras	string	необязательный
name	string	необязательный	Название накшатры для get_nakshatra_details. `AardraAasreshaAbhijitAnooraadhaAnuradhaArdraAshleshaAshwiniBharaniChitraDhanishtaDhanishtha` Название накшатры для результата `nakshatra_details`. Без учёта регистра, пробелы по краям отбрасываются. Распознаются как современные написания (Mrigashira, Ardra, Pushya, Ashlesha, Magha, Purva Phalguni, Swati, Vishakha, Anuradha, Purva Ashadha, Uttara Ashadha, Shravana, Dhanishta, Shatabhisha, Purva Bhadrapada, Uttara Bhadrapada), так и старые транслитерации движка (Mrigasira, Aardra, Pushyami, Aasresha, Makha, Poorva Phalguni, Swaati, Visaakha, Anooraadha, Poorvaashaadha, Uttaraashaadha, Sravanam, Dhanishtha, Satabhishak, Poorvaabhaadra, Uttaraabhaadra). 'Abhijit' принимается (схема из 28 накшатр). По умолчанию 'Ashwini'.
target_phase	integer	необязательный	Искомая фаза Луны: 0 = новолуние, 1 = первая четверть, 2 = полнолуние, 3 = последняя четверть.
when	string	необязательный
year	integer	необязательный	Год рождения числом, например 1990. Четыре цифры.
zodiac	string	необязательный	Знак зодиака для get_hadda_lord. `AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces`

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

curl -X POST https://api.occultapi.com/api/astro/attributes/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2024-11-21T07:45:44.368Z","longitude":76.125,"name":"Ashwini","zodiac":"Aries","lord":"saturn","target_phase":0,"limitdays":30,"year":1,"chart_factor":1}'

Ответ

{
  "data": {
    "nakshatra_pada": [
      "Aardra",
      3
    ],
    "nakshatra_details": [
      1,
      "Ketu"
    ],
    "hadda_lord": null,
    "kakshya_lord": "venus",
    "kakshya_number": 1,
    "zodiac_name": "Gemini",
    "combust_planets": {
      "Mars": false,
      "Mercury": false,
      "Venus": false,
      "Jupiter": false,
      "Saturn": false
    },
    "moon_phase": 250.14160858923307,
    "search_moon_phase": "2024-12-01T06:22:06Z",
    "seasons": {
      "spring_equinox": "0001-03-20T21:39:01Z",
      "summer_solstice": "0001-06-22T20:51:18Z",
      "autumnal_equinox": "0001-09-23T07:34:54Z",
      "winter_solstice": "0001-12-21T00:14:00Z"
    },
    "dasavarga_from_longitude": {
      "constellation": 2,
      "longitude": 16.125
    },
    "get_nakshatra_name": "Aardra"
  },
  "message": "successful",
  "is_error": false
}

Записано с реального вызова ровно с этим запросом. Результаты лежат в data.

Ошибки

Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.