/api/astro/ravi_yoga/1 кредитВікна Раві-йоги
Раві-йога діє, коли накшатра Місяця стоїть на 4, 6, 9, 10, 13 або 20 позицій від накшатри Сонця. Її вважають сприятливим часом, що переважує несприятливу загалом мухурту, і зазвичай обирають для новосілля, отримання нового транспорту, відкриття крамниці та інших разових справ. Вона залежить лише від двох накшатр, а не від місячного дня чи дня тижня, тому її можна подати безперервними вікнами з точним часом, а не позначкою на день. Відповідь — `data.rows`: список міток часу `{start, end}` у форматі ISO 8601 в UTC за запитаний рік. Вікна розбиваються на кожному сході Сонця, тож безперервний триденний проміжок подається трьома рядками поспіль, що змикаються в моменти сходу, — так їх подає Drik Panchang. Щоб відновити вихідні проміжки, об’єднайте суміжні рядки. Надішліть `year`, `latitude`, `longitude` і `timezone_as_float`. Місце впливає лише на точки розбиття за сходом Сонця, а не на саму йогу. `/api/astro/panchanga_yogas/` показує ту саму йогу як позначку на день поряд із йогами, що залежать від тітхі й дня тижня; якщо потрібен точний час початку й кінця, використовуйте цей ендпоінт.
https://api.occultapi.com/api/astro/ravi_yoga/
Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| latitude | number (double) | обов’язковий | Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. |
| longitude | number (double) | обов’язковий | Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. |
| timezone_as_float | number (double) | обов’язковий | Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. |
| end_date | string (date) | необов’язковий | |
| start_date | string (date) | необов’язковий | |
| year | integer | необов’язковий | Рік народження числом, напр. 1990. Чотири цифри. min 1800 · max 2400 |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/ravi_yoga/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'Відповідь
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"year\": 2026, \"rows\": [{\"start\": \"2026-01-01T17:18:35+00:00\", \"end\": \"2026-01-02T01:50:16+00:00\"}, {\"start\": \"2026-01-02T01:50:16+00:00\", \"end\": \"2026-01-02T14:34:10+00:00\"}, {\"start\": \"2026-01-08T06:54:39+00:00\", \"end\": \"2026-01-09T01:51:24+00:00\"}, {\"start\": \"2026-01-09T01:51:24+00:00\", \"end\": \"2026-01-09T08:10:56+00:00\"}, {\"start\": \"2026-01-25T02:19:01+00:00\", \"end\": \"2026-01-25T08:05:57+00:00\"}, {\"start\": \"2026-01-27T05:39:05+00:00\", \"end\": \"2026-01-28T01:48:11+00:00\"}, {\"start\": \"2026-01-28T01:48:11+00:00\", \"end\": \"2026-01-29T01:47:45+00:00\"}, {\"start\": \"2026-01-29T01:47:45+00:00\", \"end\": \"2026-01-29T02:01:52+00:00\"}, {\"start\": \"2026-01-30T21:57:34+00:00\", \"end\": \"2026-01-31T01:46:50+00:00\"}, {\"start\": \"2026-01-31T01:46:50+00:00\", \"end\": \"2026-01-31T20:04:13+00:00\"}, {\"start\": \"2026-02-07T20:58:37+00:00\", \"end\": \"2026-02-08T01:42:18+00:00\"}, {\"start\": \"2026-02-08T01:42:18+00:00\", \"end\": \"2026-02-08T23:32:55+00:00\"}, {\"start\": \"2026-02-20T14:37:39+00:00\", \"end\": \"2026-02-21T01:32:17+00:00\"}, {\"start\": \"2026-02-21T01:32:17+00:00\", \"end\": \"2026-02-21T13:37:16+00:00\"}, {\"start\": \"2026-02-22T12:24:48+00:00\", \"end\": \"2026-02-23T01:30:30+00:00\"}, {\"start\": \"2026-02-23T01:30:30+00:00\", \"end\": \"2026-02-23T11:03:45+00:00\"}, {\"start\": \"2026-02-25T08:08:55+00:00\", \"end\": \"2026-02-26T01:27:44+00:00\"}, {\"start\": \"2026-02-26T01:27:44+00:00\", \"end\": \"2026-02-27T01:26:47+00:00\"}, {\"start\": \"2026-02-27T01:26:47+00:00\", \"end\": \"2026-02-27T05:19:02+00:00\"}, {\"start\": \"2026-03-01T03:04:29+00:00\", \"end\": \"2026-03-02T01:23:52+00:00\"}, {\"start\": \"2026-03-02T01:23:52+00:00\", \"end\": \"2026-03-02T02:21:41+00:00\"}, {\"start\": \"2026-03-09T10:41:41+00:00\", \"end\": \"2026-03-10T01:15:40+00:00\"}, {\"start\": \"2026-03-10T01:15:40+00:00\", \"end\": \"2026-03-10T13:35:20+00:00\"}, {\"start\": \"2026-03-21T19:07:56+00:00\", \"end\": \"2026-03-22T01:02:41+00:00\"}, {\"start\": \"2026-03-22T01:02:41+00:00\", \"end\": \"2026-03-22T17:12:49+00:00\"}, {\"start\": \"2026-03-23T15:19:47+00:00\", \"end\": \"2026-03-24T01:00:29+00:00\"}, {\"start\": \"2026-03-24T01:00:29+00:00\", \"end\": \"2026-03-24T13:35:03+00:00\"}, {\"start\": \"2026-03-26T10:49:16+00:00\", \"end\": \"2026-03-27T00:57:11+00:00\"}, {\"start\": \"2026-03-27T00:57:11+00:00\", \"end\": \"2026-03-28T00:56:05+00:00\"}, {\"start\": \"2026-03-28T00:56:05+00:00\", \"end\": \"2026-03-28T09:20:23+00:00\"}, {\"start\": \"2026-03-30T09:18:08+00:00\", \"end\": \"2026-03-31T00:52:48+00:00\"}, {\"start\": \"2026-03-31T00:52:48+00:00\", \"end\": \"2026-03-31T09:51:03+00:00\"}, {\"start\": \"2026-03-31T14:40:06+00:00\", \"end\": \"2026-04-01T00:51:43+00:00\"}, {\"start\": \"2026-04-01T00:51:43+00:00\", \"end\": \"2026-04-01T10:47:41+00:00\"}, {\"start\": \"2026-04-08T00:24:04+00:00\", \"end\": \"2026-04-08T00:44:13+00:00\"}, {\"start\": \"2026-04-08T00:44:13+00:00\", \"end\": \"2026-04-09T00:43:10+00:00\"}, {\"start\": \"2026-04-09T00:43:10+00:00\", \"end\": \"2026-04-09T03:18:37+00:00\"}, {\"start\": \"2026-04-19T23:05:23+00:00\", \"end\": \"2026-04-20T00:32:13+00:00\"}, {\"start\": \"2026-04-20T00:32:13+00:00\", \"end\": \"2026-04-20T20:38:33+00:00\"}, {\"start\": \"2026-04-21T18:28:41+00:00\", \"end\": \"2026-04-22T00:30:22+00:00\"}, {\"start\": \"2026-04-22T00:30:22+00:00\", \"end\": \"2026-04-22T16:43:13+00:00\"}, {\"start\": \"2026-04-24T14:44:34+00:00\", \"end\": \"2026-04-25T00:27:40+00:00\"}, {\"start\": \"2026-04-25T00:27:40+00:00\", \"end\": \"2026-04-26T00:26:48+00:00\"}, {\"start\": \"2026-04-26T00:26:48+00:00\", \"end\": \"2026-04-26T14:57:21+00:00\"}, {\"start\": \"2026-04-29T18:46:34+00:00\", \"end\": \"2026-04-30T00:23:28+00:00\"}, {\"start\": \"2026-04-30T00:23:28+00:00\", \"end\": \"2026-04-30T20:46:58+00:00\"}, {\"start\": \"2026-05-07T13:15:59+00:00\", \"end\": \"2026-05-08T00:17:33+00:00\"}, {\"start\": \"2026-05-08T00:17:33+00:00\", \"end\": \"2026-05-08T09:13:55+00:00\"}, {\"start\": \"2026-05-19T03:11:45+00:00\", \"end\": \"2026-05-20T00:10:54+00:00\"}, {\"start\": \"2026-05-20T00:10:54+00:00\", \"end\": \"2026-05-20T00:42:03+00:00\"}, {\"start\": \"2026-05-20T22:42:18+00:00\", \"end\": \"2026-05-21T00:10:29+00:00\"}, {\"start\": \"2026-05-21T00:10:29+00:00\", \"end\": \"2026-05-21T21:19:37+00:00\"}, {\"start\": \"2026"
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.