astroAPI — POST /v1/dignities

Beschreibung

Berechnet pro Body alle klassischen Wuerden eines Punktes im Tierkreis nach Doroth/Ptolemaios. Wuerden-Score nach Lilly: domicile 5, exaltation 4, triplicity 3, term 2, face 1. Eingabe entweder ueber `datetime` (Service rechnet die 7 klassischen Planeten selbst, optional gefiltert ueber `bodies`) oder ueber `positions` (freie Map name → longitude, z.B. fuer Asc, MC, Lots). `sect` steuert, welcher Triplizitaets-Herrscher aktiv ist; wenn nicht gesetzt, wird er aus Sonnen-/Asc-Position abgeleitet (entweder aus `positions.ascendant` oder aus `datetime` + `location` via Hauesserberechnung), sonst Default `day`. `term_system` waehlt zwischen aegyptischer (Default, hellenistisch klassisch) und ptolemaeischer Term-Tabelle. Optional liefert `almuten_for` fuer eine Liste von Laengen pro klassischem Planet seine Score-Beitraege und kuert den Almuten (Sieger).

Parameter

Name	In	Typ	Pflicht	Beschreibung
`datetime`	body	string	nein	ISO 8601 UTC. Pflicht im Datetime-Modus (alternativ "positions").
`positions`	body	object	nein	Map name → ekliptikale Laenge (0..360). Alternative zu "datetime".
`bodies`	body	array	nein	Liste von Body-Namen (nur im Datetime-Modus relevant). Default: 7 klassische Planeten (sun, moon, mercury, venus, mars, jupiter, saturn).
`sect`	body	string	nein	"day" oder "night". Wenn nicht gesetzt, wird sect aus Sonne+Asc abgeleitet, falls verfuegbar; sonst Default "day".
`location.latitude`	body	number	nein	Geo-Breite +N. Range -90..90. Optional, wird nur fuer Asc-Berechnung zur Sect-Ableitung benutzt.
`location.longitude`	body	number	nein	Geo-Laenge +E. Range -180..180.
`term_system`	body	string	nein	"egyptian" (Default) oder "ptolemaic".
`almuten_for`	body	array	nein	Liste von Laengen (Grad 0..360), fuer die der Almuten berechnet wird. Max. 50 Eintraege.

Beispiel-Aufruf

Variante: Direkter HTTP-Aufruf, keine Abhaengigkeit.

curl -sS \
  -H "X-API-Key: ak_test_<DEIN_KEY>" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "datetime": "2026-04-20T12:00:00Z",
    "location": {
        "latitude": 52.5,
        "longitude": 13.4
    },
    "almuten_for": [
        12.5
    ]
}' \
  "https://astroapi.services/v1/dignities"

<?php
$ch = curl_init("https://astroapi.services/v1/dignities");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: ak_test_<DEIN_KEY>", "Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"datetime":"2026-04-20T12:00:00Z","location":{"latitude":52.5,"longitude":13.4},"almuten_for":[12.5]}');
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

<?php
require 'astroapi-client.php';
$api = new AstroApiClient('ak_test_<DEIN_KEY>');
$response = $api->dignities([
    'datetime' => '2026-04-20T12:00:00Z',
    'location' => [
        'latitude' => 52.5,
        'longitude' => 13.4,
    ],
    'almuten_for' => [
        12.5,
    ],
]);
print_r($response);

const response = await fetch('https://astroapi.services/v1/dignities', {
  method: 'POST',
  headers: { 'X-API-Key': 'ak_test_<DEIN_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "datetime": "2026-04-20T12:00:00Z",
    "location": {
        "latitude": 52.5,
        "longitude": 13.4
    },
    "almuten_for": [
        12.5
    ]
}),
});
const data = await response.json();
console.log(data);

import { AstroApiClient } from './astroapi-client.js';

const api = new AstroApiClient('ak_test_<DEIN_KEY>');
const response = await api.dignities({
    "datetime": "2026-04-20T12:00:00Z",
    "location": {
        "latitude": 52.5,
        "longitude": 13.4
    },
    "almuten_for": [
        12.5
    ]
});
console.log(response);

import requests

url = 'https://astroapi.services/v1/dignities'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
payload = {
    "datetime": "2026-04-20T12:00:00Z",
    "location": {
        "latitude": 52.5,
        "longitude": 13.4
    },
    "almuten_for": [
        12.5
    ]
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

from astroapi_client import AstroApiClient

api = AstroApiClient('ak_test_<DEIN_KEY>')
response = api.dignities({
    'datetime': '2026-04-20T12:00:00Z',
    'location': {
        'latitude': 52.5,
        'longitude': 13.4,
    },
    'almuten_for': [
        12.5,
    ],
})
print(response)