astroAPI — POST /v1/aspects

Beschreibung

Entweder "positions" (und optional "positions_b" fuer Synastrie) oder "datetime" uebergeben. Orben sind frei konfigurierbar ueber Presets oder eigene Werte. Liefert pro Aspekt Orbis, Applying/Separating, Exaktpunkt in Tagen und normierte Staerke.

Parameter

Name	In	Typ	Pflicht	Beschreibung
`positions`	body	object	nein	{ "sun": { "longitude": 25.5, "speed": 0.98 }, ... } — alternativ kann pro Punkt nur eine Zahl (longitude) uebergeben werden.
`positions_b`	body	object	nein	Zweite Positionsliste fuer Synastrie. Dann werden nur Kreuz-Paare (A×B) berechnet.
`datetime`	body	string	nein	ISO 8601 UTC. Alternative zu "positions": API berechnet die Standardplaneten selbst.
`aspect_types`	body	array	nein	["major"] \| ["minor"] \| ["major","minor"]. Default: ["major"].
`aspects`	body	array	nein	Explizite Liste, z.B. ["conjunction","trine","square"].
`orbs`	body	mixed	nein	Preset-Name ("classic" \| "tight" \| "transit" \| "progression") oder Objekt mit { "max": 5 } und/oder { "conjunction": 3, ... }. Default: "classic".

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-15T12:00:00Z",
    "orbs": {
        "max": 3
    },
    "aspect_types": [
        "major"
    ]
}' \
  "https://astroapi.services/v1/aspects"

<?php
$ch = curl_init("https://astroapi.services/v1/aspects");
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-15T12:00:00Z","orbs":{"max":3},"aspect_types":["major"]}');
$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->aspects([
    'datetime' => '2026-04-15T12:00:00Z',
    'orbs' => [
        'max' => 3,
    ],
    'aspect_types' => [
        'major',
    ],
]);
print_r($response);

const response = await fetch('https://astroapi.services/v1/aspects', {
  method: 'POST',
  headers: { 'X-API-Key': 'ak_test_<DEIN_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "datetime": "2026-04-15T12:00:00Z",
    "orbs": {
        "max": 3
    },
    "aspect_types": [
        "major"
    ]
}),
});
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.aspects({
    "datetime": "2026-04-15T12:00:00Z",
    "orbs": {
        "max": 3
    },
    "aspect_types": [
        "major"
    ]
});
console.log(response);

import requests

url = 'https://astroapi.services/v1/aspects'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
payload = {
    "datetime": "2026-04-15T12:00:00Z",
    "orbs": {
        "max": 3
    },
    "aspect_types": [
        "major"
    ]
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

from astroapi_client import AstroApiClient

api = AstroApiClient('ak_test_<DEIN_KEY>')
response = api.aspects({
    'datetime': '2026-04-15T12:00:00Z',
    'orbs': {
        'max': 3,
    },
    'aspect_types': [
        'major',
    ],
})
print(response)