POST/api/astro/attributes/1 crédit

Attributs du thème

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.

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

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_…
Content-Type: application/json

Champs de la requête

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. `saturnjupitermarssunvenusMercurymoonascendant` Correspondance 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. `AardraAasreshaAbhijitAnooraadhaAnuradhaArdraAshleshaAshwiniBharaniChitraDhanishtaDhanishtha` Nom 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`

Exemple de requête

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}'

Réponse

{
  "data": {
    "nakshatra_pada": [
      "Aardra",
      3
    ],
    "nakshatra_details": [
      1,
      "Ketu"
    ],
    "hadda_lord": null,
    "kakshya_lord": "venus",
    "kakshya_number": 1,
    "zodiac_name": "Gemini",
    "combust_planets": {
      "Mars": false,
      "Mercury": false,
      "Venus": false,
      "Jupiter": false,
      "Saturn": false
    },
    "moon_phase": 250.14160858923307,
    "search_moon_phase": "2024-12-01T06:22:06Z",
    "seasons": {
      "spring_equinox": "0001-03-20T21:39:01Z",
      "summer_solstice": "0001-06-22T20:51:18Z",
      "autumnal_equinox": "0001-09-23T07:34:54Z",
      "winter_solstice": "0001-12-21T00:14:00Z"
    },
    "dasavarga_from_longitude": {
      "constellation": 2,
      "longitude": 16.125
    },
    "get_nakshatra_name": "Aardra"
  },
  "message": "successful",
  "is_error": false
}

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.