astroAPI — POST /v1/profections

Beschreibung

Profektionen sind ein hellenistisches Zeit-Herrschaftssystem: pro Lebensjahr aktiviert sich ein Sign (beginnend mit dem Asc-Sign im 0. Lebensjahr), zykliert mod 12. Innerhalb des Jahres aktiviert sich pro 1/12 (~30.44 Tage) ein weiteres Sign (Monthly), innerhalb des Monats pro 1/12 (~2.54 Tage) ein weiteres Sign (Daily). Der "Time-Lord" einer Profektion ist der Domizilherrscher des aktivierten Sign; zusaetzlich wird der Triplizitaets-Co-Lord (je nach sect) ausgewiesen. Asc-Quelle: entweder explizit (`ascendant_longitude`) oder via `birth_location` + `house_system` (Default Placidus, Code "P"). Sect-Quelle: explizit > automatisch aus Sun+Asc beim Geburtszeitpunkt > Default `day`. Tropisches Jahr von 365.2422 Tagen.

Parameter

Name	In	Typ	Pflicht	Beschreibung
`birth_datetime`	body	string	ja	ISO 8601 UTC. Geburtszeitpunkt.
`target_datetime`	body	string	nein	ISO 8601 UTC. Bezugsmoment der Profektion. Default: jetzt. Muss >= birth_datetime sein.
`ascendant_longitude`	body	number	nein	Ekliptikale Laenge des Aszendenten zur Geburt (0..360). ENTWEDER dies ODER birth_location.
`birth_location.latitude`	body	number	nein	Geo-Breite +N. Range -90..90. Asc wird via Hauesserberechnung abgeleitet.
`birth_location.longitude`	body	number	nein	Geo-Laenge +E. Range -180..180.
`house_system`	body	string	nein	Einstelliger swe_houses-Code. Default "P" (Placidus). Beeinflusst nur die Asc-Berechnung.
`sect`	body	string	nein	"day" oder "night". Wenn nicht gesetzt: aus Sonne + Asc zum Geburtszeitpunkt; sonst Default "day".
`include_monthly`	body	boolean	nein	Monats-Profektion mitliefern. Default true.
`include_daily`	body	boolean	nein	Tages-Profektion mitliefern. Default false.

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": "1980-05-17T12:32:00Z",
    "ascendant_longitude": 170.789,
    "target_datetime": "2026-05-10T00:00:00Z",
    "include_daily": true
}' \
  "https://astroapi.services/v1/profections"

<?php
$ch = curl_init("https://astroapi.services/v1/profections");
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":"1980-05-17T12:32:00Z","ascendant_longitude":170.789,"target_datetime":"2026-05-10T00:00:00Z","include_daily":true}');
$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->profections([
    'birth_datetime' => '1980-05-17T12:32:00Z',
    'ascendant_longitude' => 170.789,
    'target_datetime' => '2026-05-10T00:00:00Z',
    'include_daily' => true,
]);
print_r($response);

const response = await fetch('https://astroapi.services/v1/profections', {
  method: 'POST',
  headers: { 'X-API-Key': 'ak_test_<DEIN_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "birth_datetime": "1980-05-17T12:32:00Z",
    "ascendant_longitude": 170.789,
    "target_datetime": "2026-05-10T00:00:00Z",
    "include_daily": true
}),
});
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.profections({
    "birth_datetime": "1980-05-17T12:32:00Z",
    "ascendant_longitude": 170.789,
    "target_datetime": "2026-05-10T00:00:00Z",
    "include_daily": true
});
console.log(response);

import requests

url = 'https://astroapi.services/v1/profections'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
payload = {
    "birth_datetime": "1980-05-17T12:32:00Z",
    "ascendant_longitude": 170.789,
    "target_datetime": "2026-05-10T00:00:00Z",
    "include_daily": true
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

from astroapi_client import AstroApiClient

api = AstroApiClient('ak_test_<DEIN_KEY>')
response = api.profections({
    'birth_datetime': '1980-05-17T12:32:00Z',
    'ascendant_longitude': 170.789,
    'target_datetime': '2026-05-10T00:00:00Z',
    'include_daily': True,
})
print(response)