astroAPI — POST /v1/heliacal

Beschreibung

Liefert pro Anfrage drei Schluesselzeitpunkte: optimum_utc (optimale Beobachtbarkeit), event_utc (klassisches heliakales Datum), end_utc (Sichtbarkeitsende). Sieben Event-Typen: heliacal_rising (Morgen-Erstsichtbarkeit nach Sonnen-Konjunktion), heliacal_setting (Abend-Letztsichtbarkeit), evening_first_visible (Abend-Erstsichtbarkeit, etwa Venus als Abendstern), morning_last_visible (Morgen-Letztsichtbarkeit), acronychal_rising/setting, cosmical_setting. `object` ist entweder ein Stern-Name aus sefstars.txt (z.B. "Sirius") oder ein Planet ("moon", "mercury", "venus", "mars", "jupiter", "saturn"). `observer` und `atmosphere` sind optional — Defaults entsprechen mittlerer Beobachtungssituation (36 Jahre, beide Augen, 1013 hPa, 15°C, 50% Feuchtigkeit, 25 km Sicht).

Parameter

Name	In	Typ	Pflicht	Beschreibung
`datetime_start`	body	string	ja	ISO 8601 UTC, Suche beginnt ab diesem Zeitpunkt.
`object`	body	string	ja	Stern-Name (sefstars.txt) oder Planet (moon\|mercury\|venus\|mars\|jupiter\|saturn).
`event_type`	body	string	ja	Event-Typ: heliacal_rising \| heliacal_setting \| evening_first_visible \| morning_last_visible \| acronychal_rising \| acronychal_setting \| cosmical_setting.
`location.latitude`	body	number	ja	Geo-Breite +N. Range -90..90.
`location.longitude`	body	number	ja	Geo-Laenge +E. Range -180..180.
`location.altitude`	body	number	nein
`atmosphere.pressure`	body	number	nein	Luftdruck hPa. Default 1013.25.
`atmosphere.temperature`	body	number	nein	Temperatur °C. Default 15.
`atmosphere.humidity`	body	number	nein	Luftfeuchtigkeit %. Default 50.
`atmosphere.meteo_range_km`	body	number	nein	Meteorologische Sichtweite in km. Default 25.
`observer.age`	body	number	nein	Alter des Beobachters. Default 36.
`observer.eyes`	body	number	nein	2 = binokular, 1 = monokular. Default 2.
`observer.magnification`	body	number	nein	Optische Vergroesserung. Default 1.
`observer.aperture_mm`	body	number	nein	Apertur in mm; 0 = blosses Auge. Default 0.
`observer.transmission`	body	number	nein	Optische Transmission. Default 1.

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_start": "2026-06-01T00:00:00Z",
    "object": "Sirius",
    "event_type": "heliacal_rising",
    "location": {
        "latitude": 30.05,
        "longitude": 31.25
    }
}' \
  "https://astroapi.services/v1/heliacal"

<?php
$ch = curl_init("https://astroapi.services/v1/heliacal");
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_start":"2026-06-01T00:00:00Z","object":"Sirius","event_type":"heliacal_rising","location":{"latitude":30.05,"longitude":31.25}}');
$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->heliacal([
    'datetime_start' => '2026-06-01T00:00:00Z',
    'object' => 'Sirius',
    'event_type' => 'heliacal_rising',
    'location' => [
        'latitude' => 30.05,
        'longitude' => 31.25,
    ],
]);
print_r($response);

const response = await fetch('https://astroapi.services/v1/heliacal', {
  method: 'POST',
  headers: { 'X-API-Key': 'ak_test_<DEIN_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "datetime_start": "2026-06-01T00:00:00Z",
    "object": "Sirius",
    "event_type": "heliacal_rising",
    "location": {
        "latitude": 30.05,
        "longitude": 31.25
    }
}),
});
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.heliacal({
    "datetime_start": "2026-06-01T00:00:00Z",
    "object": "Sirius",
    "event_type": "heliacal_rising",
    "location": {
        "latitude": 30.05,
        "longitude": 31.25
    }
});
console.log(response);

import requests

url = 'https://astroapi.services/v1/heliacal'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
payload = {
    "datetime_start": "2026-06-01T00:00:00Z",
    "object": "Sirius",
    "event_type": "heliacal_rising",
    "location": {
        "latitude": 30.05,
        "longitude": 31.25
    }
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

from astroapi_client import AstroApiClient

api = AstroApiClient('ak_test_<DEIN_KEY>')
response = api.heliacal({
    'datetime_start': '2026-06-01T00:00:00Z',
    'object': 'Sirius',
    'event_type': 'heliacal_rising',
    'location': {
        'latitude': 30.05,
        'longitude': 31.25,
    },
})
print(response)