/api/astro/nakshatra_transitions/1 кредитПереходи накшатр
Переходи кожної планети з однієї накшатри в наступну протягом календарного року, кожен — з точністю приблизно до секунди. Це таблиця «гочари планет за накшатрами»: коли Сатурн покидає Пурва Бхадрападу, коли Юпітер входить у Пуш’ю, коли Місяць змінює накшатру, — саме від цих подій відлічують час у транзитних прогнозах. granularity задає точність. 'nakshatra' працює з поділами по 13°20' і повертає from і to як прості назви; 'pada' — з чвертями по 3°20' і повертає from і to як об’єкти {nakshatra, pada}. Щоб додати Абхіджит як двадцять восьмий поділ, встановіть use_28_nakshatras у true. Передайте year і timezone_as_float. Зміщення визначає, де починається й закінчується місцевий рік, але мітки часу повертаються в UTC — для показу переведіть їх самі. Відповідь — {year, granularity, planets}, де ключами planets є назви планет (sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, rahu, ketu), а значеннями — хронологічні списки {from, to, datetime}. Лише Місяць дає за рік понад триста переходів накшатр і близько тисячі чотирьохсот переходів пад, тож відповіді з pada великі.
https://api.occultapi.com/api/astro/nakshatra_transitions/Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| granularity | string | обов’язковий | nakshatrapada |
| year | integer | обов’язковий | Рік народження числом, напр. 1990. Чотири цифри. min 1800 · max 2400 |
| timezone_as_float | number (double) | необов’язковий | Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. |
| use_28_nakshatras | boolean | необов’язковий |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/nakshatra_transitions/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"granularity":"nakshatra","year":2026,"timezone_as_float":5.5}'Відповідь
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"year\": 2026, \"granularity\": \"nakshatra\", \"planets\": {\"jupiter\": [{\"from\": \"Punarvasu\", \"to\": \"Pushyami\", \"datetime\": \"2026-06-18 15:31:55\"}, {\"from\": \"Pushyami\", \"to\": \"Aasresha\", \"datetime\": \"2026-08-18 21:42:28\"}, {\"from\": \"Aasresha\", \"to\": \"Makha\", \"datetime\": \"2026-10-31 06:32:43\"}], \"sun\": [{\"from\": \"Poorvaashaadha\", \"to\": \"Uttaraashaadha\", \"datetime\": \"2026-01-11 03:06:16\"}, {\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-01-24 05:20:24\"}, {\"from\": \"Sravanam\", \"to\": \"Dhanishtha\", \"datetime\": \"2026-02-06 08:35:04\"}, {\"from\": \"Dhanishtha\", \"to\": \"Satabhishak\", \"datetime\": \"2026-02-19 13:03:28\"}, {\"from\": \"Satabhishak\", \"to\": \"Poorvaabhaadra\", \"datetime\": \"2026-03-04 19:24:10\"}, {\"from\": \"Poorvaabhaadra\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-03-18 03:51:12\"}, {\"from\": \"Uttaraabhaadra\", \"to\": \"Revati\", \"datetime\": \"2026-03-31 14:40:06\"}, {\"from\": \"Revati\", \"to\": \"Ashwini\", \"datetime\": \"2026-04-14 04:02:39\"}, {\"from\": \"Ashwini\", \"to\": \"Bharani\", \"datetime\": \"2026-04-27 19:47:57\"}, {\"from\": \"Bharani\", \"to\": \"Krittika\", \"datetime\": \"2026-05-11 14:01:16\"}, {\"from\": \"Krittika\", \"to\": \"Rohini\", \"datetime\": \"2026-05-25 10:07:52\"}, {\"from\": \"Rohini\", \"to\": \"Mrigasira\", \"datetime\": \"2026-06-08 08:03:01\"}, {\"from\": \"Mrigasira\", \"to\": \"Aardra\", \"datetime\": \"2026-06-22 06:56:07\"}, {\"from\": \"Aardra\", \"to\": \"Punarvasu\", \"datetime\": \"2026-07-06 06:33:36\"}, {\"from\": \"Punarvasu\", \"to\": \"Pushyami\", \"datetime\": \"2026-07-20 05:58:19\"}, {\"from\": \"Pushyami\", \"to\": \"Aasresha\", \"datetime\": \"2026-08-03 04:54:24\"}, {\"from\": \"Aasresha\", \"to\": \"Makha\", \"datetime\": \"2026-08-17 02:28:46\"}, {\"from\": \"Makha\", \"to\": \"Poorva Phalguni\", \"datetime\": \"2026-08-30 22:29:09\"}, {\"from\": \"Poorva Phalguni\", \"to\": \"Uttara Phalguni\", \"datetime\": \"2026-09-13 16:17:57\"}, {\"from\": \"Uttara Phalguni\", \"to\": \"Hasta\", \"datetime\": \"2026-09-27 07:49:50\"}, {\"from\": \"Hasta\", \"to\": \"Chitra\", \"datetime\": \"2026-10-10 20:50:07\"}, {\"from\": \"Chitra\", \"to\": \"Swaati\", \"datetime\": \"2026-10-24 07:20:48\"}, {\"from\": \"Swaati\", \"to\": \"Visaakha\", \"datetime\": \"2026-11-06 15:33:21\"}, {\"from\": \"Visaakha\", \"to\": \"Anooraadha\", \"datetime\": \"2026-11-19 21:33:50\"}, {\"from\": \"Anooraadha\", \"to\": \"Jyeshtha\", \"datetime\": \"2026-12-03 01:58:15\"}, {\"from\": \"Jyeshtha\", \"to\": \"Moola\", \"datetime\": \"2026-12-16 04:55:02\"}, {\"from\": \"Moola\", \"to\": \"Poorvaashaadha\", \"datetime\": \"2026-12-29 07:14:19\"}], \"rahu\": [{\"from\": \"Satabhishak\", \"to\": \"Dhanishtha\", \"datetime\": \"2026-08-01 21:41:47\"}], \"pluto\": [{\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-02-18 02:18:30\"}, {\"from\": \"Sravanam\", \"to\": \"Uttaraashaadha\", \"datetime\": \"2026-07-29 15:00:03\"}, {\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-12-28 01:39:54\"}], \"saturn\": [{\"from\": \"Poorvaabhaadra\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-01-20 05:22:43\"}, {\"from\": \"Uttaraabhaadra\", \"to\": \"Revati\", \"datetime\": \"2026-05-17 09:07:48\"}, {\"from\": \"Revati\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-10-09 15:21:10\"}], \"uranus\": [{\"from\": \"Krittika\", \"to\": \"Rohini\", \"datetime\": \"2026-07-11 23:54:01\"}, {\"from\": \"Rohini\", \"to\": \"Krittika\", \"datetime\": \"2026-11-12 10:52:56\"}], \"mars\": [{\"from\": \"Poorvaashaadha\", \"to\": \"Uttaraashaadha\", \"datetime\": \"2026-01-11 15:40:42\"}, {\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-01-28 19:08:49\"}, {\"from\": \"Sravanam\", \"to\": \"Dhanishtha\", \"datetime\": \"2026-02-14 19:08:16\"}, {\"from\": \"Dhanishtha\", \"to\": \"Satabhishak\", \"datetime\": \"2026-03-03 17:24:52\"}, {\"from\": \"Satabhishak\", \"to\": \"Poorvaabhaadra\", \"datetime\": \"2026-03-20 15:51:47\"}, {\"from\": \"Poorvaabhaadra\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-04-06 16:26:20\"}, {\"from\": \"Uttaraabhaadra\", \"to\": \"Revati\", \"datetime\": \"2026-04-23 20:52:02\"}, {\"from\": \"Revati\", \"to\": \"Ashwini\", \"datetime\": \"2026-05-11 07:08:41\"}, {\"from\": \"Ashwini\", \"to\": \"Bharani\", \"datetime\": \"2026-05-29 00:55:31\"}, {\"from\": \"Bharani\", \"to\": \"Krittika\", \"datetime\": \"2026-06-16 04:02:43\"}, {\"from\": \"Krittika\", \"to\": \"Rohini\", \"datetime\": \"20"
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.