curl -X POST https://api.occultapi.com/api/astro/prashna/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2024-11-14T11:59:23.365Z","longitude":74.319,"latitude":26.1046,"name":"RashiChart","node_type":"true","add_yogi_longitude":true}'Прашна — це хорарна астрологія: карта, побудована на момент, коли поставлено запитання, а не на момент народження. Цей ендпоінт обчислює чутливі точки, на які спираються прашна й аналіз тривалості життя, — арифметичні поєднання довгот, які самі не є планетами, але тлумачаться як планети. Основа більшості з них — Гуліка, або Маанді, тіньова точка, пов’язана із Сатурном. Надішліть `date_time` у форматі ISO 8601, `latitude`, `longitude`, мітку `name` для карти, `node_type` (місячний вузол `true` або `mean`) і `add_yogi_longitude`. Усе повертається одразу; ключів для вибору немає. Крім `gulika_longitude`, який є простим числом градусів, кожна точка повертається як `{longitude, astrological: {degree, sign, minutes, seconds}, constellation, nakshatra, pada}` — сидерична довгота з положенням у знаку, індекс накшатри з нумерацією від 0, а також назва накшатри та її чверть. Що це за точки: `trisphuta` — асцендент плюс Місяць плюс Гуліка; `chatursphuta` додає до цього Сонце; `panchasphuta` — ще й місячний вузол. `pranasphuta` (п’ятикратний асцендент плюс Гуліка), `dehasphuta` (восьмикратний Місяць плюс Гуліка) і `mrityusphuta` (семикратна Гуліка плюс Сонце) — точки життя, тіла й смерті, а `sookshmatrisphuta` — їхня сума. `beejasphuta` (Сонце плюс Юпітер плюс Венера) і `kshetrasphuta` (Місяць плюс Юпітер плюс Марс) — чоловіча й жіноча точки фертильності. `tithisphuta` — Місяць мінус Сонце, а `rahutithisphuta` — те саме з вузлом замість Місяця. `yogisphuta` — Сонце плюс Місяць плюс 93°20', `avayogisphuta` — це значення плюс ще 186°40', а `santanatithi` — п’ять дванадцятих дуги «Місяць мінус Сонце». Зверніть увагу на три речі. `yogasphuta` — той самий розрахунок, що й `yogisphuta`, але 93°20' додається лише тоді, коли `add_yogi_longitude` дорівнює true, тож із цим прапорцем обидва поля однакові. `santanatithi` не зводиться до діапазону 0–360 і тому може бути від’ємним. А Гуліка обчислюється з фіксованим зміщенням +05:30 незалежно від переданого місця, тож для місць далеко за межами цього поясу зсуваються всі точки, похідні від Гуліки.
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| add_yogi_longitude | boolean | обов’язковий | |
| 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' — різні моменти, і відповіді для них різні. |
| latitude | number (double) | обов’язковий | Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. min -180 · max 180 |
| longitude | number (double) | обов’язковий | Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180 |
| name | string | обов’язковий | |
| node_type | string | обов’язковий | truemeanТочний збіг, у нижньому регістрі. Визначає, який місячний вузол — істинний чи середній — брати для розрахунків спхут. |