Quickstart

In drei Schritten zum ersten Aufruf

Du hast 5 Minuten. Du brauchst curl oder einen HTTP-Client deiner Wahl. Am Ende dieser Seite hast du erfolgreich GET /v1/me aufgerufen und ein Horoskop berechnet.

1. Health-Check (oeffentlich, kein Key)

Stelle sicher, dass die API antwortet:

curl -sS https://astroapi.services/v1/health

<?php
$json = file_get_contents('https://astroapi.services/v1/health');
print_r(json_decode($json, true));

const data = await fetch('https://astroapi.services/v1/health').then(r => r.json());
console.log(data);

import requests
print(requests.get('https://astroapi.services/v1/health').json())

2. API-Key besorgen

Aktuell laeuft die Key-Vergabe manuell — schreibe an ai@rd5.org mit Use-Case und geplantem Volumen. Du bekommst einen Test-Key (ak_test_...) fuer 60 Requests/h zurueck.

Zum Probieren ohne eigenen Key: nutze den Playground mit Demo-Key (60 Requests/h, IP-limitiert).

3. Erstes berechnetes Horoskop

POST /v1/radix mit Geburtsdatum (UTC) und Ort. Beispiel fuer den 20. April 2026, 12:00 UTC, Berlin (52.52° N, 13.41° E):

curl -sS \
  -H "X-API-Key: ak_test_<DEIN_KEY>" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{"birth":{"datetime":"2026-04-20T12:00:00Z","location":{"latitude":52.52,"longitude":13.41}}}' \
  https://astroapi.services/v1/radix

<?php
$ch = curl_init('https://astroapi.services/v1/radix');
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, json_encode([
    'birth' => [
        'datetime' => '2026-04-20T12:00:00Z',
        'location' => ['latitude' => 52.52, 'longitude' => 13.41],
    ],
]));
print_r(json_decode(curl_exec($ch), true));

const r = await fetch('https://astroapi.services/v1/radix', {
  method: 'POST',
  headers: {
    'X-API-Key': 'ak_test_<DEIN_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    birth: {
      datetime: '2026-04-20T12:00:00Z',
      location: { latitude: 52.52, longitude: 13.41 }
    }
  })
});
console.log(await r.json());

import requests

response = requests.post(
    'https://astroapi.services/v1/radix',
    headers={'X-API-Key': 'ak_test_<DEIN_KEY>'},
    json={'birth': {'datetime': '2026-04-20T12:00:00Z', 'location': {'latitude': 52.52, 'longitude': 13.41}}}
)
print(response.json())

Die Antwort enthaelt Planeten-Positionen (ekliptische Laenge mit Sign + Grad), Haeuser-Spitzen (Default Placidus) und die wichtigsten Achsen (Ascendant, MC, Vertex). Vollstaendiges Schema: /docs/api#post-v1-radix.

Was kommt als Naechstes?

Nutze die Endpunkt-Referenz, um deinen Use-Case abzudecken (Aspekte, Transite, Returns, Lots ...).
Verstehe Auth & Limits — vor allem das Caching mit ETag spart Anfragen und schont dein Stundenlimit.
Stoebere durch die vollstaendige ReDoc-Spec oder hol dir die OpenAPI-JSON fuer Code-Generatoren.