Введение

Панчангу и все пять её элементов, кундли и варги от D2 до D60, тридцать систем даш, йоги и доши, окна мухурты, аштакаваргу, силу планет, совместимость гороскопов, нумерологию в тринадцати системах и одиннадцать региональных календарей с их праздниками.

Всё рассчитывается на дату, время и координаты из вашего запроса — готового закэшированного альманаха нет. Почти все эндпоинты возвращают числа и классические классификации, а не текстовые толкования. Текст возвращают лишь некоторые: эндпоинт чата, общие прогнозы, рашифал и PDF-отчёты.

В основном API ведёт себя так, как вы ожидаете. Но в трёх местах — нет, и именно на них люди теряют время.

Многие эндпоинты принимают массив keys со списком нужных расчётов. Один вызов /api/astro/panchanga/ может вернуть любой из 57 результатов — смотря что вы запросите.

Все они стоят один и тот же кредит. Собрать всё нужное в один вызов — это дёшево, а не дорого. Ошибка — вызывать один эндпоинт пять раз ради пяти ключей. На странице каждого эндпоинта перечислены его допустимые ключи, а в справочнике можно искать и по маршруту, и по названию расчёта — так нужная функция находится, даже если вы не знаете, в каком она эндпоинте.

{
  "date_time": "2026-09-16T06:00:00+05:30",
  "latitude": 26.9124,
  "longitude": 75.7873,
  "timezone_as_float": 5.5,
  "keys": ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"]
}

У каждого JSON-ответа одни и те же четыре поля. Проверяйте is_error, берите результат из data, а при ошибке показывайте message: там названы конкретные поля с ошибками, а не просто «неверный запрос».

{
  "data":     { ... },        // the result; shape varies by endpoint
  "status":   200,
  "is_error": false,
  "message":  "successful"
}

Успешный вызов стоит один кредит, два PDF-отчёта и эндпоинт чата — 25. Ошибка 4xx, 5xx или тайм-аут не стоят ничего: кредит резервируется до начала расчёта и возвращается, если расчёт не завершился чисто. Так что, пока вы отлаживаете интеграцию, её ошибки не опустошат ваш баланс.

Доступ предоставляется по месячному или годовому тарифу. Его квота обновляется каждый месяц, а неиспользованные вызовы на следующий месяц не переносятся. Платы за пользователей нет, а отменить можно в любой момент. В каждом ответе есть заголовки X-Credits-Charged и X-Credits-Remaining — следить за балансом можно без лишнего вызова.

Положения планет берутся из эфемерид NASA JPL — полный набор данных, 735 неподвижных звёзд, проверено на интервале от 500 до 2999 года н. э. Медианное время ответа сервера — 62 мс, и это медиана по всем опубликованным примерам, а не по одному удачному. Медленные эндпоинты — это глубокие сканирования, и в документации они так и помечены.

В индийских традициях нет единого мнения об аянамше, поэтому API поддерживает 48 её вариантов, и любой можно скорректировать с точностью до градуса, минуты и секунды. Выбирать и объяснять выбор пользователям — вам. Мы не решаем за вас, оставив один вариант и объявив его правильным.

API считает, а не советует. Ничто в его ответах не является медицинской, юридической или финансовой рекомендацией, и, кроме немногих эндпоинтов с текстовыми ответами, он не пишет толкований. Если ваш продукт даёт советы на основе этих данных, это ваше редакционное решение. Что можно делать с результатами, описано в лицензии.

Базовый URL — https://api.occultapi.com. Помимо обычного HTTP, есть песочница, где реальные вызовы выполняются с вашим ключом (неудачный вызов ничего не стоит), коллекция Postman, спецификация OpenAPI 3.1 для генерации клиента и MCP-сервер, через который ИИ-ассистент может вызывать API напрямую.