Chargement du Playground
curl -X POST https://api.occultapi.com/api/astro/attributes/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2024-11-21T07:45:44.368Z","longitude":76.125,"name":"Ashwini","zodiac":"Aries","lord":"saturn","target_phase":0,"limitdays":30,"year":1,"chart_factor":1}'Un assortiment de douze petites valeurs du thème renvoyées en un seul appel — de quoi éviter une douzaine de requêtes. Les douze sont toujours calculées, quoi que vous envoyiez. L’ensemble couvre : le nakshatra et le pada d’une longitude écliptique donnée, le numéro et la planète maîtresse d’un nakshatra désigné par son nom, le maître Hadda (terme égyptien) d’une longitude dans un signe, le maître et le numéro du Kakshya, le signe du zodiaque d’une longitude, les planètes combustes au moment donné, l’angle de phase de la Lune, la prochaine occurrence d’une phase lunaire choisie, les quatre ingrès saisonniers d’une année et une position dans un thème divisionnaire dérivée d’une longitude. Seul `date_time` est obligatoire ; tout le reste prend une valeur par défaut (longitude 0, nom 'Ashwini', zodiaque 'Aries', maître 'saturn', target_phase 0 pour la nouvelle lune, limitdays 30, l’année en cours, chart_factor 1 pour le thème Rashi). Un appel minimal avec seulement `date_time` et `longitude` vous donne donc déjà les planètes combustes, la phase de la Lune, le nakshatra et le signe. Deux particularités : `lord` est comparé en tenant compte de la casse à des données où Mercury est stocké avec une majuscule, si bien que 'mercury' renvoie null sans avertissement alors que 'Mercury' renvoie un nombre ; et les champs `when` et `nakshatras` de la requête sont acceptés mais jamais lus.
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| date_time | string (date-time) | obligatoire | Le moment du calcul, en ISO 8601. Incluez TOUJOURS un décalage ou un Z final - une valeur sans fuseau est lue comme Asia/Kolkata (UTC+05:30), et non comme UTC, et peut renvoyer le résultat de la veille avec un statut 200. '2026-09-01T06:00:00Z' et '2026-09-01 06:00:00' sont des instants différents et donnent des réponses différentes. Contrainte de FORMAT, pas une énumération. DateTimeField DRF : ISO-8601 uniquement (formats d’entrée par défaut de DRF), p. ex. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" ou "2026-09-01 06:00:00" (sans fuseau = UTC supposé). |
| chart_factor | integer | facultatif | Facteur du thème divisionnaire pour dasavarga_from_longitude (1=Rashi, 9=Navamsa, etc.). |
| limitdays | integer | facultatif | Fenêtre de recherche en jours pour search_moon_phase. |
| longitude | number (double) | facultatif | Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine. min -180 · max 180 |
| lord | string | facultatif | Maître planétaire utilisé par get_kakshya_number. saturnjupitermarssunvenusMercurymoonascendantCorrespondance exacte, SENSIBLE à la casse. Les données elles-mêmes sont incohérentes : sept entrées sont en minuscules, mais Mercury est stocké avec une majuscule ('Mercury'). Ainsi, 'mercury' renvoie null sans avertissement alors que 'Mercury' renvoie 6. Une valeur sans correspondance renvoie null, sans erreur. Par défaut : 'saturn'. |
| nakshatras | string | facultatif | |
| name | string | facultatif | Nom de nakshatra utilisé par get_nakshatra_details. AardraAasreshaAbhijitAnooraadhaAnuradhaArdraAshleshaAshwiniBharaniChitraDhanishtaDhanishthaNom de nakshatra utilisé pour le résultat `nakshatra_details`. Insensible à la casse, espaces de début et de fin ignorés. Sont reconnues aussi bien les orthographes modernes (Mrigashira, Ardra, Pushya, Ashlesha, Magha, Purva Phalguni, Swati, Vishakha, Anuradha, Purva Ashadha, Uttara Ashadha, Shravana, Dhanishta, Shatabhisha, Purva Bhadrapada, Uttara Bhadrapada) que les translittérations anciennes du moteur (Mrigasira, Aardra, Pushyami, Aasresha, Makha, Poorva Phalguni, Swaati, Visaakha, Anooraadha, Poorvaashaadha, Uttaraashaadha, Sravanam, Dhanishtha, Satabhishak, Poorvaabhaadra, Uttaraabhaadra). 'Abhijit' est accepté (schéma à 28 nakshatras). Par défaut : 'Ashwini'. |
| target_phase | integer | facultatif | Phase lunaire à rechercher : 0=nouvelle lune, 1=premier quartier, 2=pleine lune, 3=dernier quartier. |
| when | string | facultatif | |
| year | integer | facultatif | Année de naissance sous forme de nombre, p. ex. 1990. Quatre chiffres. |
| zodiac | string | facultatif | Signe du zodiaque utilisé par get_hadda_lord. AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces |