curl -X POST https://api.occultapi.com/api/astro/traditional/dignities/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Domicile, exaltation, triplicité, terme et face pour chaque planète, avec le score de Lilly. C’est la colonne vertébrale de l’astrologie occidentale traditionnelle : c’est elle qui décide si une planète est seulement en mesure d’agir. Pour chaque planète : celles des cinq dignités qu’elle détient là où elle se trouve, ses débilités, et le total pondéré — domicile +5, exaltation +4, triplicité +3, terme +2, face +1, face à exil -5, chute -4 et pérégrin -5. TROPICAL, nécessairement. La dignité essentielle se définit par rapport au zodiaque tropical. Tous les autres endpoints de thème proposés ici sont sidéraux, et lire ces tables sur des longitudes sidérales ferait reculer presque chaque planète d’un signe et présenterait comme pérégrine une planète pourtant en domicile. La triplicité dépend de la SECTE : la secte est donc calculée d’abord, à partir de la hauteur réelle du Soleil, et renvoyée avec le résultat. Les maîtres diurne et nocturne d’un élément sont des planètes différentes, et une table appliquée avec le mauvais maître donne un résultat faux sans que rien dans la réponse ne le révèle. Les termes suivent la série égyptienne et les faces l’ordre chaldéen. Les sources divergent — les termes de Ptolémée diffèrent des termes égyptiens — c’est pourquoi le choix est indiqué dans `tables_used`, au lieu de vous laisser le déduire de nombres qui ne correspondraient pas à votre livre. La pérégrinité ne s’applique que si une planète ne détient aucune dignité et n’est ni en exil ni en chute : un même placement n’est donc jamais pénalisé deux fois. Uranus, Neptune et Pluton ne régissent rien dans cette doctrine : ils sont renvoyés avec un score null plutôt qu’avec un zéro qu’on prendrait pour une mesure.
| 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. |
| latitude | number (double) | obligatoire | Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord. min -89.9 · max 89.9 |
| longitude | number (double) | obligatoire | 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 |
| timezone_as_float | number (double) | obligatoire | Décalage UTC du lieu, en heures, sous forme décimale. Exemple : 5.5 pour l’Inde (UTC+05:30), -5 pour New York en hiver, 5.75 pour le Népal. Cette valeur n’est PAS contrôlée par rapport à date_time - si les deux divergent, vous obtenez une réponse réussie pour le mauvais moment ; tirez donc les deux de la même source. Utilisez le décalage en vigueur à cette date, pas celui d’aujourd’hui : une naissance en été dans un pays qui applique l’heure d’été exige le décalage d’été. min -12 · max 14 |
| keys | array | facultatif | Les calculs à renvoyer, sous forme de liste de noms. Consultez le tableau des clés de cet endpoint ; un nom non reconnu fait rejeter toute la requête. Un appel coûte un crédit quel que soit le nombre de clés demandées : demandez donc tout ce dont vous avez besoin en une seule fois plutôt que de faire plusieurs appels. |