Aller au contenu

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) et lucky (avec color, number). Pas de champs column, overview ni events.

Védique

  • Le corps utilise date_time (chaîne ISO 8601), latitude, longitude et timezone_as_float. Pas de champs séparés pour la date et l’heure.
  • Manglik dosha : la clé manglik renvoie une liste de trois éléments [is_manglik, cancellation_applied, cancellation_rules_matched]. Pas un simple booléen.
  • Kala Sarpa : la clé kala_sarpa renvoie un booléen. Utilisez l’endpoint astro/dosha/ avec keys: [\"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 panchanga avec date_time, latitude, longitude, timezone_as_float.

Numérologie

  • La numérologie utilise date_time, name, year, month, day (entiers). Pas de chaîne birthDate.
  • Le tableau keys dé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ètre year (année en cours par défaut).

Tarot

  • Tirage nommé : POST /api/astro/tarot/spread/ avec le paramètre spread (par ex. three_card). Pas /spreads/three-card.
  • Oui/Non : POST /api/astro/tarot/yes-no/. Le champ de réponse est strength (et non confidence). 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/ avec sequence sous 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.

Pour aller plus loin