/api/astro/prashna/1 кредитЧутливі точки прашни
Прашна — це хорарна астрологія: карта, побудована на момент, коли поставлено запитання, а не на момент народження. Цей ендпоінт обчислює чутливі точки, на які спираються прашна й аналіз тривалості життя, — арифметичні поєднання довгот, які самі не є планетами, але тлумачаться як планети. Основа більшості з них — Гуліка, або Маанді, тіньова точка, пов’язана із Сатурном. Надішліть `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 незалежно від переданого місця, тож для місць далеко за межами цього поясу зсуваються всі точки, похідні від Гуліки.
https://api.occultapi.com/api/astro/prashna/Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| 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Точний збіг, у нижньому регістрі. Визначає, який місячний вузол — істинний чи середній — брати для розрахунків спхут. |
Приклад запиту
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}'Відповідь
{
"data": {
"gulika_longitude": 243.2836111111111,
"trisphuta": {
"longitude": 277.6645540646069,
"astrological": {
"degree": 7,
"sign": "Cp",
"minutes": 39,
"seconds": 52
},
"constellation": 9,
"nakshatra": "Uttaraashaadha",
"pada": 4
},
"chatursphuta": {
"longitude": 126.06855406460689,
"astrological": {
"degree": 6,
"sign": "Le",
"minutes": 4,
"seconds": 6
},
"constellation": 4,
"nakshatra": "Makha",
"pada": 2
},
"panchasphuta": {
"longitude": 107.64255406460688,
"astrological": {
"degree": 17,
"sign": "Cn",
"minutes": 38,
"seconds": 33
},
"constellation": 3,
"nakshatra": "Aasresha",
"pada": 1
},
"pranasphuta": {
"longitude": 10.578325878590022,
"astrological": {
"degree": 10,
"sign": "Ar",
"minutes": 34,
"seconds": 41
},
"constellation": 0,
"nakshatra": "Ashwini",
"pada": 4
},
"dehasphuta": {
"longitude": 314.6596111111111,
"astrological": {
"degree": 14,
"sign": "Aq",
"minutes": 39,
"seconds": 34
},
"constellation": 10,
"nakshatra": "Satabhishak",
"pada": 3
},
"mrityusphuta": {
"longitude": 111.3892777777778,
"astrological": {
"degree": 21,
"sign": "Cn",
"minutes": 23,
"seconds": 21
},
"constellation": 3,
"nakshatra": "Aasresha",
"pada": 2
},
"sookshmatrisphuta": {
"longitude": 76.6272147674789,
"astrological": {
"degree": 16,
"sign": "Ge",
"minutes": 37,
"seconds": 37
},
"constellation": 2,
"nakshatra": "Aardra",
"pada": 3
},
"beejasphuta": {
"longitude": 152.48299999999995,
"astrological": {
"degree": 2,
"sign": "Vi",
"minutes": 28,
"seconds": 58
},
"constellation": 5,
"nakshatra": "Uttara Phalguni",
"pada": 2
},
"kshetrasphuta": {
"longitude": 162.847,
"astrological": {
"degree": 12,
"sign": "Vi",
"minutes": 50,
"seconds": 49
},
"constellation": 5,
"nakshatra": "Hasta",
"pada": 1
},
"tithisphuta": {
"longitude": 160.518,
"astrological": {
"degree": 10,
"sign": "Vi",
"minutes": 31,
"seconds": 4
},
"constellation": 5,
"nakshatra": "Hasta",
"pada": 1
},
"yogasphuta": {
"longitude": 310.65933333333334,
"astrological": {
"degree": 10,
"sign": "Aq",
"minutes": 39,
"seconds": 33
},
"constellation": 10,
"nakshatra": "Satabhishak",
"pada": 2
},
"yogisphuta": {
"longitude": 310.65933333333334,
"astrological": {
"degree": 10,
"sign": "Aq",
"minutes": 39,
"seconds": 33
},
"constellation": 10,
"nakshatra": "Satabhishak",
"pada": 2
},
"avayogisphuta": {
"longitude": 137.32600000000002,
"astrological": {
"degree": 17,
"sign": "Le",
"minutes": 19,
"seconds": 33
},
"constellation": 4,
"nakshatra": "Poorva Phalguni",
"pada": 2
},
"rahutithisphuta": {
"longitude": 133.17000000000002,
"astrological": {
"degree": 13,
"sign": "Le",
"minutes": 10,
"seconds": 12
},
"constellation": 4,
"nakshatra": "Makha",
"pada": 4
},
"santanatithi": {
"longitude": -83.11749999999999,
"astrological": {
"degree": 6,
"sign": "Cp",
"minutes": 52,
"seconds": 56
},
"constellation": 9,
"nakshatra": "Uttaraashaadha",
"pada": 4
}
},
"message": "successful",
"is_error": false
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.