AstroWay/api v2.201.6 · nl
alle systemen normaal
// astrology api · POST /v1/essential-dignities

Essentieel Waardigheden API

Essentiële waardigheden meten hoe comfortabel elke planeet in het teken en de graad zit die het bezet. Deze endpoint loopt elke planeet door het voudige traditionele schema - heerschappij, verheffing, drievoudigheid, term en gezicht - samen met de twee zwaktes, en geeft zowel een per-planeet overzicht als een enkele gewogen totaal.

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

Essentieel Waardigheden API

Gegeven een geboortemoment en -plaats, lokaliseert de endpoint elke planeet per teken en graad, en scoort deze vervolgens tegen de Ptolemaïsche waardigheidstabellen die de middeleeuwse en hellenistische praktijk hebben overgenomen. Het controleert de vijf essentiële waardigheden in aflopende sterkte - heerschappij in eigen huis, verheffing, drievoudigheidsheerschappij voor de sect van het diagram, de term of grens waarin de graad valt, en het gezicht of decan - en de twee essentiële zwaktes, nadeel en val, waarbij een planeet tegenover zijn heerschappij of verheffing zit. Elke planeet ontvangt de conventionele waardigheidspunten voor elke voorwaarde die het vervult, de zwaktes trekken af, en de cijfers rollen op tot een per-planeet overzicht onder data.waardigheden plus een diagram-brede totaalscore. Het resultaat vertelt je niet alleen welk teken een planeet in zit, maar hoe gewaardigd of verzwakt het daar is, onderscheidend tussen een planeet in zijn eigen huis en een die slechts door een teken trekt waar het geen aanspraak op heeft.

// 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

Grijp naar deze endpoint wanneer een interpretatie de planetaire kracht moet wegen in plaats van alleen posities te rapporteren - traditionele en hellenistische diagramlezers, horaire helpers, electorale scoring, of elk hulpmiddel dat rangschikt welke planeten daadwerkelijk een diagram dragen. De totaalscore geeft je een snelle scala voor sorteren of drempelwaarden, terwijl de per-planeet rijen je uitleggen waarom: deze Venus is verheven en in drievoudigheid, die Mars is in val en nadeel. Het koppelt natuurlijk met de nataaldiagram endpoint - neem de teken- en graadposities van daar en geef dezelfde geboortegegevens hier door om waardigheidsgewicht erop te leggen. Omdat het schema op regels is gebaseerd en deterministisch, leidt dezelfde invoer altijd tot dezelfde scores, wat het betrouwbaar maakt voor vergelijkingsfuncties die één diagram tegen een andere rangschikken.

// 05 / Notes

Notes

Scoring volgt de Ptolemaïsche waardigheidstabel zoals die doorgegeven is in traditionele en middeleeuwse westerse astrologie; drievoudigheidsheerschappij wordt toegewezen op basis van de sect van het diagram (dag of nacht). Planetaire posities komen van de Swiss Ephemeris (Astrodienst) engine in de tropische dierenriem, dus het teken en de graad waarop de waardigheden rusten komen precies overeen met de nataalendpoints.

Try the Essentieel Waardigheden API

Grab a key and make your first call in under a minute.

99.9% SLA · betaalde plannen · 30d status →