Formats des champs

• URL — la base https://api.occultapi.com, puis la route exactement telle qu’elle est listée, avec la barre oblique finale.
  Correct : /api/astro/tithi/, /api/astro/dasha/vimshottari/, /api/festivals/.
  Incorrect : /api/astro/tithi, /astro/tithi/, /api/astro/Tithi/.
• Authentification — votre clé dans l’en-tête X-API-Key, et Content-Type: application/json sur chaque POST.
• Méthode — POST avec un corps JSON. Les quelques consultations en GET (recherche de lieu, valeur d’ayanamsa, tableaux shalaka et données sur les catastrophes naturelles) reçoivent leurs éventuelles entrées en paramètres de requête.
  Correct : POST /api/astro/panchanga/ avec un corps JSON ; GET /api/astro/geocode/?address=Jaipur.

• date_time — ISO 8601 avec un décalage UTC ou un Z final, pour l’instant à calculer (pour un thème natal, l’instant de la naissance).
  Correct : "1990-08-15T10:30:00+05:30", "2026-09-01T00:30:00Z".
  Incorrect : "1990-08-15 10:30:00" (sans décalage : la plupart des endpoints la lisent en UTC+05:30, quelques-uns en UTC), "15/08/1990 10:30 AM".
• datetime — la même valeur sous un autre nom. /api/astro/chart/, les routes des cartes divisionnaires et /api/astro/planet-positions/ exigent cette orthographe ; les routes de dasha acceptent les deux.
• date et time — uniquement sur /api/astro/date_time/, qui prend l’heure locale et les coordonnées, et renvoie un horodatage avec le décalage en vigueur à cette date.
  Correct : "1990-08-15" et "10:30:00".
• year, month, day — de simples entiers, quand un endpoint les demande (numérologie, calendriers, recherches sur une année).
  Correct : 1990, 8, 15.

• latitude / longitude — en degrés décimaux. Le nord et l’est sont positifs, le sud et l’ouest négatifs.
  Correct : 26.9124, 75.7873 (Jaipur) ; 40.7128, -74.006 (New York).
  Incorrect : "26°54′N", des chaînes de caractères, ou 74.006 pour New York (un moins oublié la déplace en Chine).
• timezone_as_float — le décalage UTC en heures, sous forme de nombre entre -12 et 14, en vigueur à ce lieu et à cette date (heure d’été comprise).
  Correct : 5.5 (Inde), -4 (New York en été), 5.75 (Népal).
  Incorrect : "+05:30", "Asia/Kolkata", "IST".
• Sur certains endpoints, ce même décalage porte un autre nom : timezone (par exemple /api/astro/dosha/ et /api/astro/strength/), tz (/api/astro/transit/) et time_zone (/api/astro/celestial/). Envoyez le nom indiqué par l’endpoint.

• ayanamsa (endpoints sidéraux) — un nom d’ayanamsa, sans distinction de casse ; LAHIRI par défaut. /api/astro/chart/ l’exige.
  Correct : LAHIRI, KRISHNAMURTI, RAMAN, TRUE_CITRA.
  Incorrect : "kp-newcomb", "Lahiri ayanamsa". Sur /api/astro/chart/, un nom inconnu renvoie une erreur 400.
• Sur les routes /api/astro/western/ et /api/astro/return/, ayanamsa vaut TROPICAL par défaut ; passez un nom d’ayanamsa pour obtenir des positions sidérales.
• Un endpoint sans champ ayanamsa calcule avec Lahiri. /api/astro/prashna/jamakkol/ a sa propre liste, en minuscules : lahiri, true_citra, krishnamurti, raman.

• keys — un tableau JSON de noms exacts, tirés de la table des clés de l’endpoint.
  Correct : ["tithi", "vaara", "rahu_kaalam"] sur /api/astro/panchanga/.
  Incorrect : "tithi,vaara" (une chaîne), "Tithi", "rahu_kaal".
• Certaines clés exigent un champ supplémentaire, indiqué dans la table des clés : la clé phone_number de /api/astro/numerology/ a besoin d’une valeur phone_number.
• Un endpoint dont la référence n’a pas de table des clés, comme /api/astro/tithi/ ou /api/astro/rahu-kaal/, exécute toujours le même calcul ; inutile d’envoyer keys.

• chart_name sur /api/astro/chart/ — en PascalCase, sensible à la casse. Envoyez un tableau pour obtenir plusieurs cartes en un seul appel.
  Correct : "RashiChart", ["RashiChart", "NavamsaChart", "DasamsaChart"].
  Incorrect : "rashi", "D9", "Navamsa".
• notation — en minuscules : degree (degrés décimaux) ou astrological (signe, degrés, minutes, secondes).
• Nœud lunaire — rahu sur les routes de thème (true par défaut, ou mean ou both), node sur les routes de dasha et de Jaimini (true par défaut, ou mean), node_type sur Human Design et Prashna (mean par défaut, sauf sur /api/astro/prashna/, où il est obligatoire).
• house_system sur /api/astro/western/house-cusps/ — en minuscules, mots séparés par des tirets bas.
  Correct : placidus (par défaut), whole_sign, equal, koch, porphyry, regiomontanus, campanus, topocentric.
  Incorrect : "whole-sign", "W".
• rashi sur les routes de rashifal — noms des signes en anglais.
  Correct : aries, taurus, … pisces.
• system sur /api/astro/numerology/ — chaldean (par défaut), pythagorean, chinese ou vedic. Chacun a son propre jeu de clés.
• spread sur /api/astro/tarot/spread/ — three_card (par défaut), one_card, celtic_cross, horseshoe, relationship ou situation.
• sequence sur /api/astro/numerology/angel/ — le nombre observé, sous forme de chaîne.
  Correct : "1111", "444".
  Incorrect : 1111 (un nombre).
• levels sur les chronologies de dasha — de 1 à 4, 3 par défaut : 1 donne seulement les mahadashas, 2 ajoute les antardashas, 3 les pratyantardashas.

Chaque route se termine par une barre oblique. Sans elle, le serveur répond 301 avec une redirection vers l’URL avec barre oblique, et la plupart des clients HTTP suivent cette redirection en GET, sans votre corps : l’appel échoue. Copiez l’orthographe exacte de la route : certaines utilisent des tirets (/api/astro/rahu-kaal/), d’autres des tirets bas (/api/astro/monthly_panchang/), et quelques-unes se trouvent hors de /api/astro/ (/api/festivals/, /api/vrat-upavas/).

• /docs/agent-gotchas — Pièges à connaître
• /docs/agent-tasks — Mémo des tâches pour agents