Erreurs fréquentes
Les LLM produisent souvent du code défaillant, et précisément de ces façons-là. Liste recoupée avec nos journaux de production.
Astrologie
- L’horoscope, c’est
POST /api/astro/rashifal/daily/avec le corps JSON { rashi }, par ex. { "rashi": "aries" }. Pas un GET, pas un paramètre de chemin. - Le thème natal, c’est
POST /api/astro/chart/. Champs obligatoires : ayanamsa, chart_name, datetime, latitude, longitude, notation. - La réponse de l’horoscope quotidien (rashifal) contient notamment
general_prediction,aspects(avec love, career, health) etlucky(avec color, number). Pas de champscolumn,overviewnievents.
Védique
- Le corps utilise
date_time(chaîne ISO 8601),latitude,longitudeettimezone_as_float. Pas de champs séparés pour la date et l’heure. - Manglik dosha : la clé
manglikrenvoie une liste de trois éléments [is_manglik, cancellation_applied, cancellation_rules_matched]. Pas un simple booléen. - Kala Sarpa : la clé
kala_sarparenvoie un booléen. Utilisez l’endpointastro/dosha/aveckeys: [\"kala_sarpa\"]. - Endpoint de dasha :
POST /api/astro/dasha/vimshottari/. Il prend date_time, latitude, longitude, timezone_as_float. Il n’existe pas d’endpoint distinct pour les sous-dashas. - Le thème KP, c’est
POST /api/astro/kp-chart/. Pas/kp/birth-chart. - Panchang : utilisez
GET panchangaavec date_time, latitude, longitude, timezone_as_float.
Numérologie
- La numérologie utilise
date_time,name,year,month,day(entiers). Pas de chaînebirthDate. - Le tableau
keysdétermine les calculs renvoyés. Regroupez toutes les clés en un seul appel : un crédit, quel que soit leur nombre. - Clé de l’année personnelle :
personal_year_number, avec le paramètreyear(année en cours par défaut).
Tarot
- Tirage nommé :
POST /api/astro/tarot/spread/avec le paramètrespread(par ex.three_card). Pas/spreads/three-card. - Oui/Non :
POST /api/astro/tarot/yes-no/. Le champ de réponse eststrength(et nonconfidence). Valeurs possibles : "Strong" ou "Qualified", rien d’autre. - Tirer des cartes :
POST /api/astro/tarot/draw/. - Les identifiants de cartes sont en kebab-case :
fool,ace-of-cups,three-of-swords.
Yi King
- Le Yi King, c’est
POST /api/astro/numerology/iching/. Il prend date_time et name, tous deux facultatifs. Il n’existe pas d’endpoint distinct pour le tirage ou l’hexagramme du jour.
Nombres angéliques
POST /api/astro/numerology/angel/avecsequencesous forme de chaîne (par ex. "1111"). Un entier échoue à la validation.
Tous les endpoints
- Tous les endpoints POST : incluez l’en-tête
Content-Type: application/json.
Utilisation des SDK
- TypeScript : initialisez avec
new OccultApi({ apiKey }). Chaque méthode renvoie { data, error, response }. Vérifiez d’abord l’erreur. - Python :
from occult_api import OccultApi, passez des arguments nommés (kwargs), jamais positionnels. Les variantes asynchrones se terminent par_async. - PHP (8.2+) :
use function OccultAPI\Sdk\occult;puis$occult = occult($key). Appelez les méthodes avec des arguments nommés. - N’appelez jamais Occult API depuis du code côté client. Les clés API restent sur le serveur.