GET/api/astro/ayanamsa_value/1 crédit

Valeur de l’ayanamsa

L’ayanamsa est l’écart entre le zodiaque tropical, lié à l’équinoxe, et le zodiaque sidéral de l’astrologie védique, lié aux étoiles. Il augmente d’environ cinquante secondes d’arc par an : tout calcul sidéral dépend donc de l’ayanamsa choisi et de la date. Cet endpoint renvoie ce seul nombre. C’est un GET avec des paramètres de requête : `ayanamsa`, un nom tel que LAHIRI, RAMAN, KRISHNAMURTI ou TRUE_CITRA (47 définitions standard d’ayanamsa sont acceptées, sans tenir compte de la casse), et `date`, une date ISO, par défaut la date du jour. Servez-vous-en pour indiquer sur un thème l’ayanamsa avec lequel il a été dressé, ou pour mesurer l’écart entre deux définitions à une date de naissance donnée. La réponse donne la valeur sous deux formes : `value_degrees`, nombre décimal à six décimales, et `degrees`, `minutes` et `seconds`, avec une chaîne `formatted` toute prête. Le nom et la date retenue sont renvoyés tels quels. Un nom inconnu, de même que le pseudo-ayanamsa 'USER', renvoie une erreur 400.

https://api.occultapi.com/api/astro/ayanamsa_value/

Tester la requête

Authentification

Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.

X-API-Key: yt_live_a1b2c3d4_…

Paramètres de requête (2)

Ils se passent dans l’URL. Tous sont facultatifs sauf mention contraire, et ils se combinent : filtrage, puis pagination, puis tri.

Paramètre	Type		Exemple	Rôle
ayanamsa	string		—	Nom de l’ayanamsa (p. ex. LAHIRI). Par défaut : LAHIRI. Paramètre de requête GET. Insensible à la casse, .strip.upper à. Par défaut : 'LAHIRI'. 'USER' est explicitement refusé par cet endpoint, bien que le moteur d’éphémérides le connaisse. Une valeur inconnue renvoie une erreur 400 {"error": "Unknown ayanamsa..."}. au choix : FAGAN_BRADLEY, LAHIRI, DELUCE, RAMAN, USHASHASHI, KRISHNAMURTI, DJWHAL_KHUL, YUKTESHWAR, JN_BHASIN, BABYL_KUGLER1, BABYL_KUGLER2, BABYL_KUGLER3, BABYL_HUBER, BABYL_ETPSC, ALDEBARAN_15TAU, HIPPARCHOS, SASSANIAN, GALCENT_0SAG, J2000, J1900, B1950, SURYASIDDHANTA, SURYASIDDHANTA_MSUN, ARYABHATA, ARYABHATA_MSUN, SS_REVATI, SS_CITRA, TRUE_CITRA, TRUE_REVATI, TRUE_PUSHYA, GALCENT_COCHRANE, GALCENT_RGILBRAND, GALCENT_MULA_WILHELM, ARYABHATA_522, BABYL_BRITTON, TRUE_MULA, GALALIGN_MARDYKS, TRUE_SHEORAN, GALEQU_TRUE, GALEQU_MULA, GALEQU_IAU1958, GALEQU_FIORENZA, VALENS_MOON, LAHIRI_1940, LAHIRI_VP285, KRISHNAMURTI_VP291, LAHIRI_ICRC
date	string		—	Chaîne de date ISO (p. ex. 1990-05-14). Par défaut : la date du jour. Contrainte de FORMAT, pas une énumération. Toute valeur acceptée par datetime.fromisoformat de Python : 'YYYY-MM-DD' ou une date-heure ISO 8601 complète, p. ex. '1990-05-14' / '1990-05-14T12:30:00'. Un éventuel décalage horaire dans la chaîne est IGNORÉ et remplacé par UTC. Par défaut : la date du jour (UTC). Un format invalide renvoie une erreur 400.

Exemple de requête

curl "https://api.occultapi.com/api/astro/ayanamsa_value/" \
  -H "X-API-Key: $OCCULT_API_KEY"

Réponse

{
  "ayanamsa": "LAHIRI",
  "date": "2026-09-07",
  "value_degrees": 24.229844,
  "degrees": 24,
  "minutes": 13,
  "seconds": 47,
  "formatted": "24°13'47\""
}

Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.

Erreurs

Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.