astroAPI — POST /v1/primary-directions

Beschreibung

Die Koenigsdisziplin der traditionellen Prognose: Die taegliche Himmelsdrehung traegt Promissoren zu den natalen Plaetzen der Signifikatoren; der Drehbogen wird ueber den Zeitschluessel in Lebensjahre uebersetzt. Methode: Placidus-Proportional-Halbboegen, mundane Direktionen zu den Achsen (AC/MC/DC/IC) und Planet-zu-Planet; Promissoren zodiakal (Tierkreisgrad ohne Breite, Default) oder in mundo, optional mit Aspektpunkten. Nur direkte Direktionen; zirkumpolare Punkte werden mit Grund uebersprungen. Verifiziert ueber mathematische Identitaeten (Aequator-Reduktion auf RA-Differenz; Hoehe 0 am Aszendenten-Bogen).

Parameter

Name	In	Typ	Pflicht	Beschreibung
`birth`	body	object	ja	{datetime, timezone, location}.
`options.key`	body	mixed	nein	"naibod" (Default, 0.9856°/Jahr), "ptolemy" (1°/Jahr) oder Zahl 0.5..2.0.
`options.mode`	body	string	nein	"zodiacal" (Default) oder "in_mundo".
`options.promissors`	body	array	nein	Default Sonne..Saturn (max. 12).
`options.significators`	body	object	nein	{angles: ["asc","mc","dsc","ic"], bodies: ["sun","moon"]} (Defaults).
`options.aspects`	body	array	nein	Aspektpunkte der Promissoren in Grad, z. B. [0,60,90,120,180]. Default [0].
`options.age_start / age_end`	body	number	nein	Altersfenster (0..120). Default 0..90.

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 '{
    "birth": {
        "datetime": "1987-06-21T04:30:00",
        "timezone": "Europe/Berlin",
        "location": {
            "latitude": 48.137,
            "longitude": 11.575
        }
    },
    "options": {
        "key": "naibod",
        "age_end": 50
    }
}' \
  "https://astroapi.services/v1/primary-directions"

<?php
$ch = curl_init("https://astroapi.services/v1/primary-directions");
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, '{"birth":{"datetime":"1987-06-21T04:30:00","timezone":"Europe/Berlin","location":{"latitude":48.137,"longitude":11.575}},"options":{"key":"naibod","age_end":50}}');
$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->primaryDirections([
    'birth' => [
        'datetime' => '1987-06-21T04:30:00',
        'timezone' => 'Europe/Berlin',
        'location' => [
            'latitude' => 48.137,
            'longitude' => 11.575,
        ],
    ],
    'options' => [
        'key' => 'naibod',
        'age_end' => 50,
    ],
]);
print_r($response);

const response = await fetch('https://astroapi.services/v1/primary-directions', {
  method: 'POST',
  headers: { 'X-API-Key': 'ak_test_<DEIN_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "birth": {
        "datetime": "1987-06-21T04:30:00",
        "timezone": "Europe/Berlin",
        "location": {
            "latitude": 48.137,
            "longitude": 11.575
        }
    },
    "options": {
        "key": "naibod",
        "age_end": 50
    }
}),
});
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.primaryDirections({
    "birth": {
        "datetime": "1987-06-21T04:30:00",
        "timezone": "Europe/Berlin",
        "location": {
            "latitude": 48.137,
            "longitude": 11.575
        }
    },
    "options": {
        "key": "naibod",
        "age_end": 50
    }
});
console.log(response);

import requests

url = 'https://astroapi.services/v1/primary-directions'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
payload = {
    "birth": {
        "datetime": "1987-06-21T04:30:00",
        "timezone": "Europe/Berlin",
        "location": {
            "latitude": 48.137,
            "longitude": 11.575
        }
    },
    "options": {
        "key": "naibod",
        "age_end": 50
    }
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

from astroapi_client import AstroApiClient

api = AstroApiClient('ak_test_<DEIN_KEY>')
response = api.primary_directions({
    'birth': {
        'datetime': '1987-06-21T04:30:00',
        'timezone': 'Europe/Berlin',
        'location': {
            'latitude': 48.137,
            'longitude': 11.575,
        },
    },
    'options': {
        'key': 'naibod',
        'age_end': 50,
    },
})
print(response)