Типові помилки
Ось де саме LLM найчастіше генерують неробочий код. Звірено з логами робочого сервера.
Астрологія
- Гороскоп — це
POST /api/astro/rashifal/daily/з JSON-тілом { rashi }, наприклад { "rashi": "aries" }. Не GET і не параметр шляху. - Натальна карта — це
POST /api/astro/chart/. Обов’язкові поля: ayanamsa, chart_name, datetime, latitude, longitude, notation. - У відповіді щоденного гороскопа (рашифалу) є поля
general_prediction,aspects(з love, career, health) іlucky(з color, number). Полівcolumn,overviewчиeventsнемає.
Ведична
- У тілі запиту —
date_time(рядок ISO 8601),latitude,longitudeіtimezone_as_float. Не окремі поля для дати й часу. - Манглік-доша: ключ
manglikповертає список із трьох елементів [is_manglik, cancellation_applied, cancellation_rules_matched], а не одне булеве значення. - Кала-сарпа: ключ
kala_sarpaповертає булеве значення. Викликайте ендпоінтastro/dosha/зkeys: [\"kala_sarpa\"]. - Ендпоінт даш:
POST /api/astro/dasha/vimshottari/. Приймає date_time, latitude, longitude, timezone_as_float. Окремого ендпоінта для піддаш немає. - Карта KP — це
POST /api/astro/kp-chart/, а не/kp/birth-chart. - Панчанг:
GET panchangaз date_time, latitude, longitude, timezone_as_float.
Нумерологія
- Нумерологія приймає
date_time,name,year,month,day(цілі числа). Не рядокbirthDate. - Масив
keysвизначає, які розрахунки повернуться. Збирайте всі ключі в один виклик — це один кредит, скільки б їх не було. - Ключ особистого року:
personal_year_numberз параметромyear(за замовчуванням — поточний рік).
Таро
- Розклад:
POST /api/astro/tarot/spread/з параметромspread(наприклад,three_card). Не/spreads/three-card. - Так/ні:
POST /api/astro/tarot/yes-no/. Поле відповіді —strength(неconfidence). Значення — лише "Strong" або "Qualified". - Витягнути карти:
POST /api/astro/tarot/draw/. - Ідентифікатори карт — у kebab-case:
fool,ace-of-cups,three-of-swords.
І Цзін
- І Цзін — це
POST /api/astro/numerology/iching/. Приймає необов’язкові date_time і name. Окремих ендпоінтів daily чи cast немає.
Ангельські числа
POST /api/astro/numerology/angel/ізsequenceу вигляді рядка (наприклад, "1111"). Ціле число не пройде валідацію.
Усі ендпоінти
- Для всіх POST-ендпоінтів додавайте заголовок
Content-Type: application/json.
Робота з SDK
- TypeScript: ініціалізуйте через
new OccultApi({ apiKey }). Кожен метод повертає { data, error, response }. Спершу перевіряйте error. - Python:
from occult_api import OccultApi; передавайте іменовані аргументи (kwargs), ніколи не позиційні. Асинхронні варіанти закінчуються на_async. - PHP (8.2+):
use function OccultAPI\Sdk\occult;, потім$occult = occult($key). Викликайте методи з іменованими аргументами. - Ніколи не викликайте Occult API з клієнтського коду. Місце API-ключа — на сервері.