Часті запитання

Скільки коштує один виклик?

Один кредит за успішний виклик, хоч би скільки даних він повернув. Винятки — ендпоінти PDF-звітів і ШІ-чату: 25 кредитів за виклик. Запит на один розрахунок і на сорок коштує однаково, бо багато ендпоінтів приймають масив `keys`, і всі ключі одного запиту покриває той самий один кредит.

Чи стягується плата за невдалі запити?

Ні. Occult API ніколи не бере плату за невдалий запит. Кредит резервується перед запуском розрахунку й повертається, якщо той не завершився успішно. Тож 4xx, 5xx чи тайм-аут нічого не коштують, а інтеграція з помилками не спустошить баланс, поки ви її налагоджуєте. Кожна відповідь повідомляє реальну вартість у заголовку X-Credits-Charged.

Чи згорають кредити?

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

Чи є безкоштовний тариф?

Нові акаунти отримують безкоштовні кредити, які можна витрачати на робочому API зі справжнім ключем, а не в пісочниці з власними даними. Крім того, Playground на 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 публікує Угоду про обробку даних відповідно до статті 28 GDPR, а також актуальний перелік субобробників, де названо кожну третю сторону, що може мати доступ до даних клієнтів.

Якщо вашого запитання тут немає, пишіть на mridul.kabra23@gmail.com. Що ми виміряли, а що ні, — на сторінці методології; що ми зберігаємо і чого не створювали — на сторінці прозорості. Повний перелік кодів помилок — у розділі автентифікації, зокрема пояснення, чому 402 не є помилкою автентифікації.