astroAPI — POST /v1/progressions

Beschreibung

Progressierte Positionen und Exakt-Kontakte mit Radix. "method": "secondary" (1 Tag = 1 Jahr), "tertiary" (1 Tag = 1 tropischer Monat — Mond-Feinzyklen), "minor" (1 tropischer Monat = 1 Jahr) oder "solar_arc" (alle Punkte um Sonnenbogen verschoben). Snapshot via "age_years"/"at", Window via "age_start"/"age_end". Default-Orben: "progression" (1° pauschal). Mit "phases": ["ingress","station"] liefert der Window-Modus statt Radix-Aspekten die Zeichenwechsel (ingresses) und Stationen (stations) der progressierten Planeten/Asteroiden; "axis" ergaenzt die AC/MC-Zeichenwechsel (Jahresdrift-Methode, nur Sekundaer, benoetigt den Geburtsort im "natal"-Objekt).

Parameter

Name	In	Typ	Pflicht	Beschreibung
`method`	body	string	nein	"secondary" (Default), "tertiary", "minor" oder "solar_arc".
`natal`	body	object	nein	{ datetime, timezone, location } — API berechnet Radix-Positionen und Haeuser.
`natal_positions`	body	object	nein	Vorberechnete Radix-Longitudes. Braucht dann zusaetzlich "birth_jd" (Julian Day UT der Geburt).
`birth_jd`	body	number	nein	Julian Day UT der Geburt. Pflicht wenn "natal_positions" statt "natal" genutzt wird.
`age_years`	body	number	nein	Zielalter in Jahren (Snapshot). Alternative: "at".
`at`	body	string	nein	Zieldatum ISO 8601 (Snapshot). Wird aus Geburts-JD in Alter umgerechnet.
`age_start`	body	number	nein	Fenster-Beginn in Jahren. Zusammen mit "age_end" aktiviert Window-Modus.
`age_end`	body	number	nein	Fenster-Ende in Jahren.
`step_years`	body	number	nein	Schrittweite fuer Window-Scan. Default 0.1 Jahr (~37 Tage).
`moving_points`	body	array	nein	Welche Punkte progressiert werden. Default: Sonne-Pluto + Chiron.
`aspect_frame`	body	string	nein	Aspekt-Bezug im Window-Modus (ohne "phases"): "progressed_natal" (Default, progressiv × Radix), "progressed_progressed" (progressiv untereinander) oder "transit_progressed" (Transit × progressiv). Bildet die drei Sekundaerprogressions-Ansichten (1 Kreis / Sek→Radix / Transit→Sek) ab. Hinweis fuer "transit_progressed": die transitierende Seite bewegt sich real-schnell — schnelle Koerper (v. a. Mond) ueber lange Fenster mit grobem "step_years" aliasieren und werden bei 8000 Ereignissen gedeckelt; fuer Transit-Listen langsame Koerper und/oder feinen "step_years" waehlen.
`phases`	body	array	nein	Nur Window-Modus. Teilmenge von ["ingress","station","axis"]. Gesetzt → Antwort enthaelt "ingresses"/"stations" der progressierten Planeten/Asteroiden statt Radix-Aspekten ("events"); "axis" ergaenzt "axis_ingresses" (AC/MC-Zeichenwechsel, Jahresdrift, nur Sekundaer, benoetigt Geburtsort im "natal"-Objekt).
`aspect_types\|aspects\|orbs`	body	mixed	nein	Wie bei anderen Endpunkten. Default-Orben: "progression" (1° pauschal).

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 '{
    "method": "secondary",
    "natal": {
        "datetime": "1980-05-17T14:32:00",
        "timezone": "Europe/Berlin",
        "location": {
            "latitude": 52.52,
            "longitude": 13.405
        }
    },
    "age_start": 40,
    "age_end": 50
}' \
  "https://astroapi.services/v1/progressions"

<?php
$ch = curl_init("https://astroapi.services/v1/progressions");
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, '{"method":"secondary","natal":{"datetime":"1980-05-17T14:32:00","timezone":"Europe/Berlin","location":{"latitude":52.52,"longitude":13.405}},"age_start":40,"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->progressions([
    'method' => 'secondary',
    'natal' => [
        'datetime' => '1980-05-17T14:32:00',
        'timezone' => 'Europe/Berlin',
        'location' => [
            'latitude' => 52.52,
            'longitude' => 13.405,
        ],
    ],
    'age_start' => 40,
    'age_end' => 50,
]);
print_r($response);

const response = await fetch('https://astroapi.services/v1/progressions', {
  method: 'POST',
  headers: { 'X-API-Key': 'ak_test_<DEIN_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "method": "secondary",
    "natal": {
        "datetime": "1980-05-17T14:32:00",
        "timezone": "Europe/Berlin",
        "location": {
            "latitude": 52.52,
            "longitude": 13.405
        }
    },
    "age_start": 40,
    "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.progressions({
    "method": "secondary",
    "natal": {
        "datetime": "1980-05-17T14:32:00",
        "timezone": "Europe/Berlin",
        "location": {
            "latitude": 52.52,
            "longitude": 13.405
        }
    },
    "age_start": 40,
    "age_end": 50
});
console.log(response);

import requests

url = 'https://astroapi.services/v1/progressions'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
payload = {
    "method": "secondary",
    "natal": {
        "datetime": "1980-05-17T14:32:00",
        "timezone": "Europe/Berlin",
        "location": {
            "latitude": 52.52,
            "longitude": 13.405
        }
    },
    "age_start": 40,
    "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.progressions({
    'method': 'secondary',
    'natal': {
        'datetime': '1980-05-17T14:32:00',
        'timezone': 'Europe/Berlin',
        'location': {
            'latitude': 52.52,
            'longitude': 13.405,
        },
    },
    'age_start': 40,
    'age_end': 50,
})
print(response)