Errores frecuentes

Estos son los fallos concretos que suelen tener los LLM al generar código. Comprobados con los registros de producción.

Astrología

El horóscopo es POST /api/astro/rashifal/daily/ con el cuerpo JSON { rashi }, p. ej. { "rashi": "aries" }. No es un GET ni un parámetro de ruta.
La carta natal es POST /api/astro/chart/. Necesita ayanamsa, chart_name, datetime, latitude, longitude y notation.
La respuesta del horóscopo diario (rashifal) incluye, entre otros, los campos general_prediction, aspects (con love, career y health) y lucky (con color y number). No hay campos column, overview ni events.

El cuerpo usa date_time (cadena ISO 8601), latitude, longitude y timezone_as_float. No hay campos separados para la fecha y la hora.
Manglik dosha: la clave manglik devuelve una lista de tres elementos [is_manglik, cancellation_applied, cancellation_rules_matched], no un único booleano.
Kala Sarpa: la clave kala_sarpa devuelve un booleano. Usa el endpoint astro/dosha/ con keys: [\"kala_sarpa\"].
Endpoint de dasha: POST /api/astro/dasha/vimshottari/. Recibe date_time, latitude, longitude y timezone_as_float. No hay un endpoint aparte para los subdashas.
La carta KP es POST /api/astro/kp-chart/, no /kp/birth-chart.
Panchang: usa GET panchanga con date_time, latitude, longitude y timezone_as_float.

La numerología usa date_time, name, year, month y day (enteros), no una cadena birthDate.
El array keys decide qué cálculos se devuelven. Pide todas las claves en una sola llamada: cuesta un crédito, sean cuantas sean.
Clave del año personal: personal_year_number, con el parámetro year (por defecto, el año en curso).

Tirada: POST /api/astro/tarot/spread/ con el parámetro spread (p. ej. three_card), no /spreads/three-card.
Sí/No: POST /api/astro/tarot/yes-no/. El campo de la respuesta es strength (no confidence), y sus únicos valores son "Strong" o "Qualified".
Sacar cartas: POST /api/astro/tarot/draw/.
Los ID de las cartas van en kebab-case: fool, ace-of-cups, three-of-swords.

El I Ching es POST /api/astro/numerology/iching/. Acepta date_time y name, ambos opcionales. No hay endpoints aparte para la lectura diaria ni para la tirada.

POST /api/astro/numerology/angel/ con sequence como cadena (p. ej. "1111"). Con un entero, la validación falla.

En todos los endpoints POST, incluye la cabecera Content-Type: application/json.

TypeScript: inicializa con new OccultApi({ apiKey }). Todos los métodos devuelven { data, error, response }. Comprueba primero el error.
Python: from occult_api import OccultApi; pasa argumentos con nombre (kwargs), nunca posicionales. Las variantes asíncronas terminan en _async.
PHP (8.2+): use function OccultAPI\Sdk\occult; y luego $occult = occult($key). Llama a los métodos con argumentos con nombre.
Nunca llames a Occult API desde el código del cliente. Las claves de API van en el servidor.