/api/astro/dasha_applicability/1 кредитЗастосовність даш
У ведичній астрології багато систем планетних періодів, і більшість накшатрових систем, крім Вімшоттарі, умовні: класичні тексти приписують застосовувати Аштоттарі лише тоді, коли в карті виконується певна умова, Двадашоттарі — лише за іншої умови і так далі. Помилковий вибір означає, що людині на все життя побудують не ту часову шкалу. Цей ендпоінт перевіряє ці умови за вас. Він будує карти раші, навамші та двадасамші для даних народження й перевіряє шість умовних систем — Аштоттарі, Чатурасіті Сама, Двадашоттарі, Двісаптаті, Панчоттарі та Сатабдіка, — кожну за тією картою, за якою її оцінюють у класиці. Надішліть момент і місце народження разом із `year_option` (тривалість року в днях), `start_option` і `direction_option` — це ті самі налаштування періодів, що їх приймають ендпоінти даш. За результатом вирішуйте, який ендпоінт даші викликати далі.
https://api.occultapi.com/api/astro/dasha_applicability/Автентифікація
Передавайте ключ у заголовку 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). |
| direction_option | string | обов’язковий | forwardbackwardЗ урахуванням регістру, у нижньому регістрі. Будь-яке інше значення повертає 400 "Invalid direction: must be 'forward' or 'backward'". |
| keys | array | обов’язковий | Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами. applicability_checkМасив рядків; доступний лише один ключ. |
| latitude | number (double) | обов’язковий | Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. min -90 · max 90 |
| longitude | number (double) | обов’язковий | Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180 |
| start_option | string | обов’язковий | currentnextpreviousЗ урахуванням регістру, у нижньому регістрі. Будь-яке інше значення повертає 400 "Invalid start value: must be 'current', 'next', or 'previous'". Максимальна довжина — 100. |
| timezone_as_float | number (double) | обов’язковий | Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. min -12 · max 14 |
| year_option | number (double) | обов’язковий | 365.256364365.24219365.25365360min 360 · max 365.256364 |
Доступні ключі (1)
Перелічіть у keys саме ті розрахунки, які вам потрібні. Один невідомий ключ — і відхиляється весь запит. Скільки б ключів ви не запитали, спишеться 1 кредит, тож збирайте їх в один виклик.
| Ключ | Додаткові поля | Опис |
|---|---|---|
| applicability_check | — | Умовні системи накшатра-даш, класичні умови яких виконуються в цій карті, — список назв для відображення з набору "Ashtottari Dasha", "Chaturaseeti Sama Dasha", "Dwadashottari Dasha", "Dwisaptati Dasha", "Panchottari Dasha" і "Sataabdika Dasha". Порожній список означає, що жодна з шести не застосовна. Вімшоттарі безумовна, тому її тут немає. |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/dasha_applicability/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["applicability_check"],"date_time":"2025-03-27T09:52:50.441Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year_option":365.256364,"start_option":"current","direction_option":"forward"}'Відповідь
{
"data": {
"applicability_check": []
},
"status": 200,
"is_error": false,
"message": "successful"
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data під тими ключами, які ви запитали.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.