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

Сканування нітья-йоги за рік

Нітья-йога — це одна двадцять сьома кола, яке утворює сума сидеричних довгот Сонця й Місяця. Кожна з двадцяти семи йог — від Вішкамбхи до Вайдхріті — триває трохи менше доби, і вони важливі для вибору сприятливого часу: В’ятіпати, Вайдхріті, Паригхи, В’ягхати, Шули, Ганди й Атіганди за традицією уникають, а Сіддхі, Сіддху, Шубху, йоги класу Амріта та Сукарму, навпаки, шукають. Ендпоінт приймає назву однієї йоги й повертає всі її настання за календарний рік. `yoga_name` чутливе до регістру й має точно збігатися зі значенням переліку. `year` і `timezone_as_float` визначають, який місцевий рік охопити; координати не потрібні, бо йога змінюється в той самий момент для всієї Землі. Сума двох довгот зростає приблизно на 13 градусів 20 хвилин кожні 22.6 години, тож кожна йога настає приблизно чотирнадцять-п’ятнадцять разів на рік. Відповідь — `{year, yoga_name, rows}`, де `rows` — хронологічний список міток часу `{start, end}` у форматі ISO в UTC. Кожна пара — справжні моменти початку й кінця йоги, знайдені бісекцією суми довгот Сонця й Місяця, а не перевіркою на схід Сонця, тож межі точні до частки секунди.

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

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

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

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

Поля запиту

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

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

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

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

min 1800 · max 2400

yoga_namestringобов’язковий
VishkambhaPreetiAyushmanSaubhagyaShobhanaAtigandaSukarmaDhritiShoolaGandaVriddhiDhruva

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

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

Відповідь

{
  "data": {
    "year": 2026,
    "yoga_name": "Vishkambha",
    "rows": [
      {
        "start": "2026-01-04T20:17:27.999999+00:00",
        "end": "2026-01-05T17:17:16.999999+00:00"
      },
      {
        "start": "2026-01-30T11:28:35.999999+00:00",
        "end": "2026-01-31T08:03:35.999999+00:00"
      },
      {
        "start": "2026-02-24T22:56:20.999999+00:00",
        "end": "2026-02-25T19:58:43.999999+00:00"
      },
      {
        "start": "2026-03-22T10:11:35.999999+00:00",
        "end": "2026-03-23T06:52:06.999999+00:00"
      },
      {
        "start": "2026-04-17T01:51:55.999999+00:00",
        "end": "2026-04-17T22:15:28.999999+00:00"
      },
      {
        "start": "2026-05-12T17:49:31.999999+00:00",
        "end": "2026-05-13T15:24:49.999999+00:00"
      },
      {
        "start": "2026-06-07T04:31:57.999999+00:00",
        "end": "2026-06-08T03:58:13.999999+00:00"
      },
      {
        "start": "2026-07-02T11:09:21.999999+00:00",
        "end": "2026-07-03T11:30:01.999999+00:00"
      },
      {
        "start": "2026-07-27T17:24:55.999999+00:00",
        "end": "2026-07-28T18:03:37.999999+00:00"
      },
      {
        "start": "2026-08-21T23:48:40.999999+00:00",
        "end": "2026-08-23T00:44:33.999999+00:00"
      },
      {
        "start": "2026-09-16T06:52:40.999999+00:00",
        "end": "2026-09-17T07:19:46.999999+00:00"
      },
      {
        "start": "2026-10-11T15:35:35.999999+00:00",
        "end": "2026-10-12T15:02:25.999999+00:00"
      },
      {
        "start": "2026-11-05T23:39:40.999999+00:00",
        "end": "2026-11-06T22:40:11.999999+00:00"
      },
      {
        "start": "2026-12-01T06:45:12.999999+00:00",
        "end": "2026-12-02T05:01:50.999999+00:00"
      },
      {
        "start": "2026-12-26T18:52:33.999999+00:00",
        "end": "2026-12-27T15:23:47.999999+00:00"
      }
    ]
  },
  "message": "successful",
  "is_error": false
}

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

Помилки

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