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

Сканирование каран

Карана — половина титхи: шесть градусов удаления Луны от Солнца, примерно от одиннадцати до тринадцати часов. Всего одиннадцать каран: семь подвижных, каждая из которых повторяется восемь раз за лунный месяц, и четыре неподвижных, которые встречаются по одному разу. Неблагоприятной считается Vishti, которую обычно называют Bhadra. Этот эндпоинт находит все периоды одной названной караны за весь календарный год, так что список «когда следующая Vishti» можно построить, не перебирая год день за днём. Передайте 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. Подробнее — в справочнике ошибок.