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

Сканування тітхі за рік

Тітхі — це одна тридцята місячного місяця: час, за який елонгація Місяця від Сонця зростає ще на 12 градусів. Майже всі індуські обряди визначаються саме за тітхі, а тітхі не збігаються з цивільними днями: тітхі може тривати лише близько дев’ятнадцяти годин або аж близько двадцяти шести, тож одна тітхі часто охоплює дві дати. Ендпоінт приймає одну конкретну тітхі й повертає всі її настання за календарний рік з істинними моментами початку й кінця. `tithi_number` — від 1 до 30: 1-15 — від Шукла Пратіпади до Пурніми, 16-29 — від Крішна Пратіпади до Чатурдаші, а 30 — Амавасья. `year` — місцевий календарний рік, а `timezone_as_float` визначає, який саме це місцевий рік (5.5 для IST). Координати не потрібні: тітхі починається й закінчується в той самий момент для всієї Землі. Відповідь — `{year, tithi_number, rows}`, де `rows` — хронологічний список міток часу `{start, end}` у форматі ISO в UTC; зазвичай це дванадцять або тринадцять записів, бо кожна тітхі повторюється раз на місячний місяць. Вікна не розбиваються за проміжними сходами Сонця, тож тітхі, що охоплює два цивільні дні, повертається одним рядком.

https://api.occultapi.com/api/astro/tithi_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: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення.

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

min 1 · max 30

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

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

min 1800 · max 2400

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

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

Відповідь

{
  "data": {
    "year": 2026,
    "tithi_number": 1,
    "rows": [
      {
        "start": "2026-01-18T19:52:39+00:00",
        "end": "2026-01-19T20:45:19+00:00"
      },
      {
        "start": "2026-02-17T12:01:47+00:00",
        "end": "2026-02-18T11:28:41+00:00"
      },
      {
        "start": "2026-03-19T01:24:05+00:00",
        "end": "2026-03-19T23:23:24+00:00"
      },
      {
        "start": "2026-04-17T11:52:21+00:00",
        "end": "2026-04-18T08:41:36+00:00"
      },
      {
        "start": "2026-05-16T20:01:32+00:00",
        "end": "2026-05-17T16:11:46+00:00"
      },
      {
        "start": "2026-06-15T02:54:39+00:00",
        "end": "2026-06-15T23:01:51+00:00"
      },
      {
        "start": "2026-07-14T09:44:04+00:00",
        "end": "2026-07-15T06:21:58+00:00"
      },
      {
        "start": "2026-08-12T17:37:11+00:00",
        "end": "2026-08-13T15:12:30+00:00"
      },
      {
        "start": "2026-09-11T03:27:28+00:00",
        "end": "2026-09-12T02:17:22+00:00"
      },
      {
        "start": "2026-10-10T15:50:36+00:00",
        "end": "2026-10-11T16:02:05+00:00"
      },
      {
        "start": "2026-11-09T07:02:42+00:00",
        "end": "2026-11-10T08:31:14+00:00"
      },
      {
        "start": "2026-12-09T00:52:31+00:00",
        "end": "2026-12-10T03:17:14+00:00"
      }
    ]
  },
  "message": "successful",
  "is_error": false
}

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

Помилки

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