AstroWay/api v2.201.6 · fr
tous les systèmes sont opérationnels
// astrology api · POST /v1/essential-dignities

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é.

Endpoint
POST /v1/essential-dignities
Cost
20 credits
Latency
~62 ms
Tier
Tier 2
// 01 / What it computes

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.

// 02 / Live request

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
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "dignities": [
      {
        "planet": "Venus",
        "rulership": false,
        "exaltation": true,
        "triplicity": true,
        "score": 7
      }
    ],
    "totalScore": 12
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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).
// 04 / When to use it

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.

// 05 / Notes

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.

99,9% SLA · forfaits payants · 30 j statut →