Частые вопросы

Сколько стоит один вызов?

Один кредит за успешный вызов, сколько бы данных он ни вернул. Исключения — эндпоинты PDF-отчётов и ИИ-чата: 25 кредитов за вызов. Запрос одного расчёта стоит столько же, сколько запрос сорока: многие эндпоинты принимают массив `keys`, и все ключи в одном запросе покрываются тем же одним кредитом.

Платить ли за неудачные запросы?

Нет. Occult API никогда не берёт плату за неудачный запрос. Кредит резервируется перед расчётом и возвращается, если расчёт не завершился чисто. Поэтому 4xx, 5xx или тайм-аут ничего не стоят, и недоработанная интеграция не съест баланс, пока вы её отлаживаете. Сколько на самом деле стоил каждый ответ, видно в заголовке X-Credits-Charged.

Сгорают ли кредиты?

Квота тарифа обновляется каждый месяц. Occult API продаётся по месячным или годовым тарифам: каждый месяц начисляется новая квота, а вызовы, не использованные за месяц, на следующий не переносятся. Годовые тарифы работают так же — двенадцать месячных квот с оплатой разом.

Есть ли бесплатный тариф?

Новые аккаунты получают бесплатные кредиты, которые можно тратить в рабочем API с настоящим ключом, а не в песочнице с отдельными данными. Кроме того, песочница на occultapi.com/playground делает настоящие вызовы к работающему API с вашим ключом, и неудачный вызов там ничего не стоит.

Нужна ли подписка?

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

Мне приходит 402. С ключом что-то не так?

Нет. Ответ 402 с сообщением insufficient_credits значит, что API-ключ действителен, а квота исчерпана. Перевыпуск ключа не поможет — повысьте тариф или дождитесь ежемесячного обновления квоты. Проблему с самим ключом означает только 401 invalid_api_key.

Можно ли использовать API-ключ в браузере или мобильном приложении?

Нет. Ключ Occult API — серверный секрет. Ключ во фронтенд-JavaScript или в сборке мобильного приложения прочитает любой, кто установит приложение или откроет инструменты разработчика, и сможет тратить ваш баланс. Вызывайте API со своего сервера, а клиенту открывайте собственный эндпоинт.

Я потерял ключ. Можете прислать его ещё раз?

Нет, и это сделано намеренно. Occult API хранит ключи только в виде хешей SHA-256, поэтому восстановить ключ не сможет ни администратор, ни дамп базы данных. Создайте новый ключ и отзовите старый: отзыв действует сразу и не влияет на баланс кредитов.

Что делать, если ключ утёк?

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

Откуда берутся расчёты?

Occult API считает по эфемеридам NASA JPL — полному набору данных с 735 неподвижными звёздами, охватывающему годы с 500 по 2999 н. э. Ничего не берётся из заранее посчитанных таблиц альманаха: каждый ответ рассчитывается для точного момента и координат из запроса.

Ваш результат расходится с другим источником. Почему?

Обычно дело в аянамше. Индийские традиции действительно расходятся в этом вопросе, а разница в один градус может перенести планету через границу накшатры. Occult API поддерживает 48 аянамш, и каждую можно скорректировать до градуса, минуты и секунды. Поэтому первым делом проверьте, одинаковая ли аянамша у обоих источников.

Насколько это быстро?

Медианное время ответа на сервере — 62 мс. Замер сделан по всем опубликованным примерам, а не по выбранному одному. Несколько эндпоинтов выполняют глубокие расчёты — полный перебор варшапхалы, раши-даша на год — и работают секунды. В справочнике это прямо указано, а не спрятано за медианой.

Есть ли спецификация OpenAPI или SDK?

Occult API публикует документ OpenAPI 3.1 по адресу occultapi.com/openapi.json. Он собирается из того же каталога, что и документация, и для каждой операции содержит пример: 255 из 299 примеров записаны с работающего сервера, остальные построены по схеме запроса. С ним можно сгенерировать типизированный клиент на любом языке через openapi-generator или аналог. Есть также коллекция Postman и MCP-сервер для ИИ-ассистентов.

Может ли его вызывать ИИ-ассистент?

Да. У Occult API есть MCP-сервер, который открывает все эндпоинты через пять инструментов. Поиск эндпоинтов и чтение схем запросов через него бесплатны — платить нужно только за сам расчёт, так что ассистент может изучить весь API, ничего не потратив. Памятка для ИИ-агентов, пишущих код, опубликована на occultapi.com/AGENTS.md.

Можно ли продавать то, что возвращает API?

Да. Occult API предоставляет безвозмездную лицензию на коммерческое использование данных в ваших продуктах: можно хранить ответы в своей базе данных, создавать и продавать отчёты и использовать данные в работе для клиентов. Указывать источник не обязательно. Запрещено только перепродавать сам доступ к API в виде API.

Вы храните данные рождения, которые я отправляю?

Нет. Дата, время и место из запроса используются для расчёта ответа и после этого в базу данных не записываются. По каждому вызову хранятся эндпоинт, время, HTTP-статус и списанные кредиты — это нужно для отчётов об использовании и вопросов по оплате.

Вы предлагаете DPA?

Да. Occult API публикует Соглашение об обработке данных (DPA) по статье 28 GDPR, а также актуальный список субобработчиков, где названы все третьи стороны, которые могут получить доступ к данным клиентов.

Если вашего вопроса здесь нет, напишите на mridul.kabra23@gmail.com. Что мы измерили, а что нет, — на странице методологии; что мы храним и чего пока не сделали — на странице прозрачности. Полный список кодов ошибок — в разделе аутентификации, там же объяснено, почему 402 — это не ошибка аутентификации.