Два шляхи, залежно від того, чи будуєте ви UI, чи хочете готовий файл.
Шлях перший: POST /api/v3/timing/solar-return повертає структурований аналіз року як JSON.
Надішліть birth_data суб'єкта плюс return_year - і отримаєте назад кутові планети, господаря року в його SR-домі, світило секти в домі, знак SR Ascendant та SR Місяць і Сонце за домами.
Це шар даних.
Використовуйте його, коли рендерите власний календар, дашборд чи колесо карти.
Шлях другий: POST /api/v3/pdf/solar-return-report повертає готовий документ на ~34 сторінки для тих самих вхідних даних.
Використовуйте його, коли хочете відшліфований звіт, щоб надіслати поштою чи продати без фронтенд-роботи.
PDF - це той самий JSON-аналіз, розписаний простою мовою, плюс додаткові секції на кшталт символів Sabian і таймлайну гарячих місяців.
Для обох однакові birth_data і return_year, тож ви можете пропонувати живе представлення і завантаження з одного набору вхідних даних.
JSON для вашого UI, PDF для готового документа