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

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

Дванадцять дрібних величин карти одним викликом — замість десятка окремих запитів. Обчислюються завжди всі дванадцять, хоч би що ви надіслали. До набору входять: накшатра й пада для заданої екліптичної довготи; номер накшатри та її планета-управитель за назвою; володар хадди (єгипетського терму) для довготи в межах знака; володар какшьї та номер какшьї; знак зодіаку для довготи; планети, спалені в заданий момент; фазовий кут Місяця; наступне настання обраної фази Місяця; чотири моменти сезонних інгресій року; положення в дробовій карті, обчислене з довготи. Обов’язкове лише `date_time`; для решти є значення за замовчуванням (довгота 0, назва 'Ashwini', знак зодіаку 'Aries', володар 'saturn', target_phase 0 для молодика, limitdays 30, поточний рік, chart_factor 1 для карти раші). Тож мінімальний виклик лише з `date_time` і `longitude` уже дає спалені планети, фазу Місяця, накшатру та знак. Дві особливості: `lord` зіставляється з даними з урахуванням регістру, а Меркурій там записано з великої літери, тож '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=Rashi, 9=Navamsa тощо).
limitdays	integer	необов’язковий	Вікно пошуку в днях для search_moon_phase.
longitude	number (double)	необов’язковий	Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180
lord	string	необов’язковий	Планета-володар, яку використовує get_kakshya_number. `saturnjupitermarssunvenusMercurymoonascendant` Точний збіг З УРАХУВАННЯМ регістру. Самі дані непослідовні: сім записів у нижньому регістрі, але Меркурій збережено з великої літери як '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. Детальніше — у довіднику помилок.