astroAPI — POST /v1/nodes-apsides

Beschreibung

Liefert pro Koerper die Bahnknoten und Bahn-Extrempunkte mit Laenge, Zeichen, Breite und Distanz. "method": "mean" (glatt, fuer Mond..Neptun; Mond-mean entspricht exakt dem Mean Node) oder "osculating" (wahre Momentanbahn; Mond-osculating ≈ True Node). Geozentrische Knoten oszillieren stark — fuer die klassischen Tabellenwerte (z. B. Mars-Knoten ~19°45′ Stier) "heliocentric": true setzen.

Parameter

Name	In	Typ	Pflicht	Beschreibung
`datetime`	body	string	ja	ISO 8601 UTC.
`bodies`	body	array	nein	Default: Mond + Merkur..Pluto. Auch chiron/ceres/… (dann automatisch osculating).
`method`	body	string	nein	"mean" (Default) oder "osculating".
`heliocentric`	body	boolean	nein	true = heliozentrische Knoten/Apsiden (klassische Werte). 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 '{
    "datetime": "2026-06-11T00:00:00Z",
    "bodies": [
        "mars"
    ],
    "method": "osculating",
    "heliocentric": true
}' \
  "https://astroapi.services/v1/nodes-apsides"

<?php
$ch = curl_init("https://astroapi.services/v1/nodes-apsides");
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-06-11T00:00:00Z","bodies":["mars"],"method":"osculating","heliocentric":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->nodesApsides([
    'datetime' => '2026-06-11T00:00:00Z',
    'bodies' => [
        'mars',
    ],
    'method' => 'osculating',
    'heliocentric' => true,
]);
print_r($response);

const response = await fetch('https://astroapi.services/v1/nodes-apsides', {
  method: 'POST',
  headers: { 'X-API-Key': 'ak_test_<DEIN_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "datetime": "2026-06-11T00:00:00Z",
    "bodies": [
        "mars"
    ],
    "method": "osculating",
    "heliocentric": 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.nodesApsides({
    "datetime": "2026-06-11T00:00:00Z",
    "bodies": [
        "mars"
    ],
    "method": "osculating",
    "heliocentric": true
});
console.log(response);

import requests

url = 'https://astroapi.services/v1/nodes-apsides'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
payload = {
    "datetime": "2026-06-11T00:00:00Z",
    "bodies": [
        "mars"
    ],
    "method": "osculating",
    "heliocentric": 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.nodes_apsides({
    'datetime': '2026-06-11T00:00:00Z',
    'bodies': [
        'mars',
    ],
    'method': 'osculating',
    'heliocentric': True,
})
print(response)