Перейти до вмісту
Occult API
POST/api/astro/karana_scan/1 кредит

Сканування каран

Карана — це половина тітхі: шість градусів віддалення Місяця від Сонця, приблизно від одинадцяти до тринадцяти годин. Назв усього одинадцять: сім рухомих, кожна з яких повторюється вісім разів за місячний місяць, і чотири фіксовані, що трапляються по одному разу. Уникають Вішті, яку зазвичай називають Бхадрою. Цей ендпоінт знаходить усі періоди однієї заданої карани за весь календарний рік, тож ви можете скласти список «коли наступна Вішті», не перебираючи рік день за днем. Передайте karana_name у точності як у списку значень поля (регістр важливий), year і timezone_as_float; зміщення визначає, де починається й закінчується місцевий рік. Широта й довгота не потрібні, бо карана — суто місячна величина. Відповідь — {year, karana_name, rows}, де rows — хронологічний список міток часу {start, end} в UTC. Фіксована карана дає близько дванадцяти рядків на рік, рухома — ближче до сотні. Карани одного дня повертає ключ karana_segments в /api/astro/panchanga/ — для цього використовуйте його.

https://api.occultapi.com/api/astro/karana_scan/
Спробувати запит

Автентифікація

Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запиту

ПолеТипОбов’язковеПримітки
karana_namestringобов’язковий
KimstughnaBavaBalavaKaulavaTaitulaGarajaVanijaVishtiShakuniChatushpadaNaga
timezone_as_floatnumber (double)обов’язковий

Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення.

yearintegerобов’язковий

Рік народження числом, напр. 1990. Чотири цифри.

min 1800 · max 2400

Приклад запиту

curl -X POST https://api.occultapi.com/api/astro/karana_scan/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"karana_name":"Kimstughna","timezone_as_float":5.5,"year":2026}'

Відповідь

{
  "data": {
    "year": 2026,
    "karana_name": "Kimstughna",
    "rows": [
      {
        "start": "2026-01-18T19:52:39+00:00",
        "end": "2026-01-19T08:22:04+00:00"
      },
      {
        "start": "2026-02-17T12:01:47+00:00",
        "end": "2026-02-17T23:48:42+00:00"
      },
      {
        "start": "2026-03-19T01:24:05+00:00",
        "end": "2026-03-19T12:26:49+00:00"
      },
      {
        "start": "2026-04-17T11:52:21+00:00",
        "end": "2026-04-17T22:18:56+00:00"
      },
      {
        "start": "2026-05-16T20:01:32+00:00",
        "end": "2026-05-17T06:07:05+00:00"
      },
      {
        "start": "2026-06-15T02:54:39+00:00",
        "end": "2026-06-15T12:57:08+00:00"
      },
      {
        "start": "2026-07-14T09:44:04+00:00",
        "end": "2026-07-14T20:00:36+00:00"
      },
      {
        "start": "2026-08-12T17:37:11+00:00",
        "end": "2026-08-13T04:21:33+00:00"
      },
      {
        "start": "2026-09-11T03:27:28+00:00",
        "end": "2026-09-11T14:48:43+00:00"
      },
      {
        "start": "2026-10-10T15:50:36+00:00",
        "end": "2026-10-11T03:52:40+00:00"
      },
      {
        "start": "2026-11-09T07:02:42+00:00",
        "end": "2026-11-09T19:43:50+00:00"
      },
      {
        "start": "2026-12-09T00:52:31+00:00",
        "end": "2026-12-09T14:03:05+00:00"
      }
    ]
  },
  "message": "successful",
  "is_error": false
}

Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.

Помилки

Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.