Перейти до вмісту

Типові помилки

Ось де саме 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-ключа — на сервері.

Що далі