Zwei Wege, je nachdem, ob du die UI baust oder eine fertige Datei willst.
Weg eins: POST /api/v3/timing/solar-return liefert die strukturierte Jahresanalyse als JSON.
Sende die subject birth_data plus ein return_year und du bekommst die Eckplaneten, den Lord of the Year in seinem SR-Haus, das Sekt-Licht im Haus, das Zeichen des SR-Aszendenten sowie SR-Mond und -Sonne nach Haus zurück.
Das ist die Datenschicht.
Nutze sie, wenn du deinen eigenen Kalender, dein Dashboard oder dein Chart-Rad renderst.
Weg zwei: POST /api/v3/pdf/solar-return-report liefert für dieselben Eingaben ein fertiges ~34-seitiges Dokument.
Nutze ihn, wenn du einen polierten Report zum Mailen oder Verkaufen ohne Frontend-Arbeit willst.
Das PDF ist die JSON-Analyse in einfacher Sprache ausformuliert, plus zusätzliche Abschnitte wie Sabische Symbole und eine Timeline der heißen Monate.
Für beide dieselben birth_data und dasselbe return_year, sodass du die Live-Ansicht und den Download aus einem Satz Eingaben anbieten kannst.
JSON für deine eigene UI, PDF für ein fertiges Dokument