API des Dignités Essentielles
Les dignités essentielles mesurent à quel point chaque planète se trouve à l'aise dans le signe et le degré qu'elle occupe. Cet endpoint soumet chaque corps au schéma traditionnel en cinq volets - domination, exaltation, triplicité, terme et face - ainsi qu'aux deux faiblesses, et renvoie à la fois une décomposition par planète et un total unique pondéré.
API des Dignités Essentielles
Étant donné un moment et un lieu de naissance, l'endpoint localise chaque planète par signe et degré, puis la note en fonction des tables de dignité ptolémaïque héritées par la pratique médiévale et hellénistique. Il vérifie les cinq dignités essentielles par ordre de force décroissante - domination du domicile, exaltation, domination de la triplicité pour le secte du thème, le terme ou le bord dans lequel tombe le degré, et la face ou le décant - et les deux faiblesses essentielles, décadence et chute, où une planète se trouve en face de sa domination ou de son exaltation. Chaque planète reçoit les points de dignité conventionnels pour chaque condition qu'elle remplit, les faiblesses soustraient, et les chiffres s'accumulent dans une décomposition par corps sous data.dignities plus un totalScore global au thème. Le résultat vous indique non seulement dans quel signe se trouve une planète, mais aussi dans quelle mesure elle est dignifiée ou affaiblie là, distinguant une planète dans son propre foyer d'une qui ne traverse simplement un signe dont elle n'a aucun droit.
POST/v1/essential-dignities
curl -X POST https://api.astroway.info/v1/essential-dignities \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52
}' {
"ok": true,
"data": {
"dignities": [
{
"planet": "Venus",
"rulership": false,
"exaltation": true,
"triplicity": true,
"score": 7
}
],
"totalScore": 12
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
When to use it
Utilisez cet endpoint chaque fois qu'une interprétation doit peser la force planétaire plutôt que de simplement rapporter les positions - les lecteurs de thèmes traditionnels et hellénistiques, les assistants horaires, le score électif, ou tout outil qui classe quelles planètes portent réellement un thème. Le score total vous donne un scalaire rapide pour le tri ou le seuillage, tandis que les lignes par planète vous permettent d'expliquer pourquoi : cette Vénus est exaltée et en triplicité, ce Mars est en chute et en décadence. Il s'associe naturellement à l'endpoint natal-chart - prenez les positions de signe et degré de là et passez les mêmes données de naissance ici pour superposer le poids de la dignité. Comme le schéma est basé sur des règles et déterministe, la même entrée donne toujours les mêmes scores, ce qui le rend fiable pour les fonctionnalités de comparaison qui classent un thème par rapport à un autre.
Notes
Le scoring suit la table de dignité ptolémaïque telle qu'elle a été transmise dans l'astrologie occidentale traditionnelle et médiévale ; la domination de la triplicité est assignée par secte du thème (jour ou nuit). Les positions planétaires proviennent du moteur de l'Éphéméride suisse (Astrodienst) dans le zodiaque tropical, donc le signe et le degré sur lesquels reposent les dignités correspondent exactement aux endpoints nataux.
Try the Dignités Essentielles API
Grab a key and make your first call in under a minute.