Типичные ошибки
Именно в этих местах 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/. - ID карт — в kebab-case:
fool,ace-of-cups,three-of-swords.
И-цзин
- И-цзин —
POST /api/astro/numerology/iching/. Необязательные параметры: date_time и name. Отдельных эндпоинтов для ежедневной гексаграммы или гадания нет.
Ангельские числа
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-ключам место на сервере.