astroAPI — POST /v1/aspect-events

Beschreibung

Beantwortet die Frage "WANN wird der Aspekt exakt" — im Gegensatz zu POST /v1/aspects, das einen Snapshot liefert ("welche Winkel gelten zu EINEM Zeitpunkt, mit welchem Orb"). Hier gibt es keinen Orb: gesucht ist genau der Moment, in dem er 0 wird. Geprueft wird jede Kombination aus Body-Paar und Aspekt; der Zeitpunkt wird per Regula Falsi auf unter eine Sekunde eingegrenzt. Mundane Betrachtung (Planet gegen Planet) — fuer Kontakte zu einem Geburtshoroskop siehe POST /v1/transits. Nicht-symmetrische Aspekte werden in beide Richtungen geprueft: ein Sextil liegt vor, wenn "first" 60° VOR oder 60° HINTER "second" steht. Retrograde Dreifach-Aspekte erscheinen als drei getrennte Events. Default-Bodies: Sonne + 8 Planeten OHNE Mond (36 Paare, gemessen 182 Events im Jahr 2020). Der Mond ist per "bodies" zuschaltbar, wuerde die Antwort aber dominieren: mit ihm sind es 1.120 Events im selben Jahr, seine neun Paare allein machen also 84 % aus. Neben den Major-Aspekten sind alle Eintraege aus config/aspects.json erlaubt (Quincunx, Halbquadrat, Quintil …). Maximales Fenster: 365 Tage.

Parameter

Name	In	Typ	Pflicht	Beschreibung
`start`	body	string	ja	ISO 8601 UTC, Beginn des Fensters.
`end`	body	string	ja	ISO 8601 UTC, Ende des Fensters. Maximal 365 Tage nach "start".
`bodies`	body	array	nein	Liste von Body-Namen; geprueft wird jedes Paar daraus. Default: ["sun","mercury","venus","mars","jupiter","saturn","uranus","neptune","pluto"] (36 Paare). Unbekannte Namen werden still verworfen; unter zwei gueltigen Bodies gibt es kein Paar und damit keine Events.
`aspects`	body	array	nein	Liste von Aspekt-Namen aus config/aspects.json. Default: die 5 Major-Aspekte ["conjunction","opposition","trine","square","sextile"]. Unbekannte Namen werden still verworfen.
`step_days`	body	number	nein	Abtast-Schrittweite. Default 1.0, Range 0.1-7.0. Beeinflusst NICHT die Genauigkeit des gemeldeten Zeitpunkts (die kommt aus der Verfeinerung), sondern nur, ob ein sehr kurzes Aspekt-Fenster zwischen zwei Abtastpunkten uebersehen wird — relevant bei Aspekten, die ein Planet dicht an seiner Station nur streift.

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 '{
    "start": "2020-01-01T00:00:00Z",
    "end": "2020-06-30T00:00:00Z",
    "bodies": [
        "saturn",
        "pluto"
    ],
    "aspects": [
        "conjunction"
    ]
}' \
  "https://astroapi.services/v1/aspect-events"

<?php
$ch = curl_init("https://astroapi.services/v1/aspect-events");
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, '{"start":"2020-01-01T00:00:00Z","end":"2020-06-30T00:00:00Z","bodies":["saturn","pluto"],"aspects":["conjunction"]}');
$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->aspectEvents([
    'start' => '2020-01-01T00:00:00Z',
    'end' => '2020-06-30T00:00:00Z',
    'bodies' => [
        'saturn',
        'pluto',
    ],
    'aspects' => [
        'conjunction',
    ],
]);
print_r($response);

const response = await fetch('https://astroapi.services/v1/aspect-events', {
  method: 'POST',
  headers: { 'X-API-Key': 'ak_test_<DEIN_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "start": "2020-01-01T00:00:00Z",
    "end": "2020-06-30T00:00:00Z",
    "bodies": [
        "saturn",
        "pluto"
    ],
    "aspects": [
        "conjunction"
    ]
}),
});
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.aspectEvents({
    "start": "2020-01-01T00:00:00Z",
    "end": "2020-06-30T00:00:00Z",
    "bodies": [
        "saturn",
        "pluto"
    ],
    "aspects": [
        "conjunction"
    ]
});
console.log(response);

import requests

url = 'https://astroapi.services/v1/aspect-events'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
payload = {
    "start": "2020-01-01T00:00:00Z",
    "end": "2020-06-30T00:00:00Z",
    "bodies": [
        "saturn",
        "pluto"
    ],
    "aspects": [
        "conjunction"
    ]
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

from astroapi_client import AstroApiClient

api = AstroApiClient('ak_test_<DEIN_KEY>')
response = api.aspect_events({
    'start': '2020-01-01T00:00:00Z',
    'end': '2020-06-30T00:00:00Z',
    'bodies': [
        'saturn',
        'pluto',
    ],
    'aspects': [
        'conjunction',
    ],
})
print(response)