Перейти к основному содержимому

Типичные ошибки

Именно в этих местах 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-ключам место на сервере.

Что дальше