astroAPI — POST /v1/firdaria

Beschreibung

Firdaria ist ein hellenistisch-persisches Time-Lord-System: die Lebensspanne von 75 Jahren wird auf 9 Hauptperioden verteilt (7 klassische Planeten + Nord-Knoten 3 J + Sued-Knoten 2 J), die Reihenfolge ist sect-abhaengig (day = Sonnen-Reihe Sun-Venus-Mercury-Moon-Saturn-Jupiter-Mars-NN-SN; night = Mond-Reihe Moon-Saturn-Jupiter-Mars-Sun-Venus-Mercury-NN-SN). Pro Planet-Hauptperiode 7 Subperioden zu je Hauptlaenge/7, beginnend mit dem Hauptlord, dann chaldaeische Reihe (Saturn-Jupiter-Mars-Sun-Venus-Mercury-Moon zyklisch). Knoten haben klassisch keine Subperioden. Sect-Quelle: explizit > automatisch aus Sun+Asc beim Geburtszeitpunkt (braucht birth_location) > Default day. Tropisches Jahr 365.2422 Tage. Nach 75 Jahren ist `current` null und `beyond_life_span` true.

Parameter

Name	In	Typ	Pflicht	Beschreibung
`birth_datetime`	body	string	ja	ISO 8601 UTC. Geburtszeitpunkt.
`target_datetime`	body	string	nein	ISO 8601 UTC. Bezugsmoment. Default: jetzt. Muss >= birth_datetime sein.
`sect`	body	string	nein	"day" oder "night". ENTWEDER explizit ODER via birth_location automatisch ableiten.
`birth_location.latitude`	body	number	nein	Geo-Breite +N. Range -90..90. Nur fuer Auto-Sect noetig.
`birth_location.longitude`	body	number	nein	Geo-Laenge +E. Range -180..180.
`house_system`	body	string	nein	Einstelliger swe_houses-Code fuer Asc-Berechnung. Default "P" (Placidus).
`include_all_periods`	body	boolean	nein	Alle 9 Hauptperioden mit Start-/End-Zeit auflisten. 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",
    "sect": "day",
    "include_all_periods": true
}' \
  "https://astroapi.services/v1/firdaria"

<?php
$ch = curl_init("https://astroapi.services/v1/firdaria");
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","sect":"day","include_all_periods":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->firdaria([
    'birth_datetime' => '1980-05-17T12:32:00Z',
    'sect' => 'day',
    'include_all_periods' => true,
]);
print_r($response);

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

import requests

url = 'https://astroapi.services/v1/firdaria'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
payload = {
    "birth_datetime": "1980-05-17T12:32:00Z",
    "sect": "day",
    "include_all_periods": 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.firdaria({
    'birth_datetime': '1980-05-17T12:32:00Z',
    'sect': 'day',
    'include_all_periods': True,
})
print(response)