Overzicht van de Horoscope Reports API¶
Ontwikkel astrologische producten op een deterministische engine aangedreven door Swiss Ephemeris, ontworpen voor productie-applicaties.
Deze API ondersteunt twee hoogwaardige rapportmodi:
Public modevoor stabiele, sign-gebaseerde output op grote schaal.Personalized modevoor redactierapporten met geboortedata, met diepere vectoren (huizen, aspecten, timingdynamiek).
Taalnotatie: engine-aangedreven
/api/v1/horoscope/reports/*endpoints ondersteunen momenteel alleen Engels (lang=en). Niet-rapport endpoints kunnen opties voor vertaalhulp ondersteunen, indien gedocumenteerd.
Duidelijkheid van de Reactie van het Zodiac Systeem¶
Wanneer u zodiac_system: "tropical" selecteert, blijft de rapportberekening tropisch. Wanneer u zodiac_system: "sidereal" selecteert, blijft de rapportberekening sideraal.
Als er geen zodiac_system wordt verstrekt in het verzoeklichaam, gaat de engine standaard naar tropical.
U kunt nog steeds tropische, siderale en ayanamsa-gerelateerde velden zien in de responsmetadata, ongeacht de geselecteerde modus.Deze velden worden alleen ter vergelijking, transparantie en observatie geretourneerd. Ze hebben geen invloed op de daadwerkelijke berekeningen van het rapport voor het geselecteerde zonnekalender systeem.
Dagelijkse App UI Statistieken in Focus¶
De belangrijkste dagelijkse gepersonaliseerde endpoints onthullen rijke, gebruiksvriendelijke statistieken op data.daily_personalized_stats.
Gepersonaliseerde dagelijkse statistieken omvatten:
overall_pulsearchetype_scoresharmony_discordelemental_balancemomentum_channelsconfidenceper blok
Gebruik daily_stats_detail: "full" | "compact" om de payload-dichtheid voor mobiele/web clients te controleren.
Architectuur¶
Volledige Engine Architectuur¶

Vraag-naar-Antwoord Architectuur¶

Runtime Breakdown¶
De productie horoscoop stack volgt een deterministische pipeline:1. API Gateway valideert authenticatie, quota en verzoekbeleid. 2. FastAPI app valideert het contract en controleert de cache. 3. HoroscopeService lost signaal, tijdsperiode, ephemerisconfiguratie en modus op. 4. EphemerisEngine berekent posities, aspecten, huizen, ascendant. 5. AggregationEngine extraheert periodieke gebeurtenissen, metrics en gerangschikte drijfveren. 6. InterpretationEngine koppelt factor stacks aan de output met traceerbaarheid. 7. De reactie wordt samengesteld, verpakt met metadata en gecached.
Deze architectuur zorgt voor reproduceerbare resultaten voor identieke payloads, terwijl het toch diepe personalisatie mogelijk maakt voor betaalde app-ervaringen.
Vertrouwmodel: Gesloten Kern + Open Source Lite¶
Ons belangrijkste motor is open source en geoptimaliseerd voor deterministische rapporten van enterprise-kwaliteit, premium redactionele lagen en productbetrouwbaarheid.
Om transparantie en ontwikkelaarsvertrouwen te bevorderen, onderhouden we ook een robuuste, lichte open-source motor:
- OpAstro website: opastro.com
- OpAstro broncode: github.com/dakidarts/opastro
- OpAstro package: pypi.org/project/opastroGebruik OpAstro om de kwaliteit van het engine snel te evalueren, en schaal vervolgens naar de enterprise routes van NumerologyAPI voor uitgebreidere rapportlagen, een breder bereik aan endpoints en beheerde productie-operaties.
Begin hier¶
- Diepgaande analyse van het engine: Introductie van ons Horoscope Engine
- Release notes: Numerology API v1.0.0 Changelog
- Kernoverzicht routes:
- Vandaag's Horoscoop
- Morgen's Horoscoop
- Gisteren's Horoscoop
- Verjaardags Horoscoop
- Volledige Natal Chart
Snelstart: Gepersonaliseerd dagelijks + App statistieken¶
curl --request POST \
--url "https://api.numerologyapi.com/api/v1/horoscope/reports/today?lang=en" \
--header "X-API-Key: YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"dob": "1992-07-16",
"timezone": "America/New_York",
"birth_time": "13:45",
"birth_latitude": 40.7128,
"birth_longitude": -74.0060,
"birth_timezone": "America/New_York",
"daily_stats_detail": "compact"
}'
Dit retourneert een live dagelijks rapport plus data.daily_personalized_stats voor app kaarten en trend modules.
Route Selectie Gids¶
| Doel | Aanbevolen Endpoint Familie |
|---|---|
| Algemeen dagelijks rapport op basis van het teken | /horoscope/reports/today, /horoscope/reports/tomorrow, /horoscope/reports/yesterday |
| Gepersonaliseerd dagelijks rapport + app statistieken | Dagelijkse hoofdroutes met birth_time, coördinaten en daily_stats_detail |
| Periodieke algemene rapporten | /horoscope/reports/weekly, /horoscope/reports/monthly, /horoscope/reports/yearly |
| Rapporten specifiek voor een sectie (carrière, gezondheid, geld, communicatie, vriendschap, levensstijl, liefde) | Routes voor secties over perioden |
| Rapporten met focus op planeten | Planet routes |
| Rapporten met focus op aspecten | Aspects routes |
| Rapporten met focus op transits | Transits routes |
| Gepersonaliseerde rapporten met focus op huizen | House routes |
| Gepersonaliseerde rapporten met focus op planeten en huizen | Planet-house routes |
| Volledige geboorte chart + artefacten | Birth chart routes |
Endpoint Map¶
Gebruik deze kaart om direct naar de exacte route familie te springen die uw product nodig heeft.
Geboorte Chart en Fundamenten¶
Dagelijkse Horoscoop- Horoscoop van gisteren¶
- Horoscoop van vandaag
- Horoscoop van morgen
- Algemene dagelijkse horoscoop (per dag)
- Algemene dagelijkse horoscoop (voor morgen)
- Algemene dagelijkse horoscoop (voor gisteren)
- Carrière: Horoscoop van vandaag
- Carrière: Horoscoop van morgen
- Carrière: Horoscoop van gisteren
- Gezondheid: Horoscoop van vandaag
- Gezondheid: Horoscoop van morgen
- Gezondheid: Horoscoop van gisteren
- Communicatie: Horoscoop van vandaag
- Communicatie: Horoscoop van morgen
- Communicatie: Horoscoop van gisteren
- Vriendschap: Horoscoop van vandaag
- Vriendschap: Horoscoop van morgen
- Vriendschap: Horoscoop van gisteren
- Leefstijl: Horoscoop van vandaag
- Leefstijl: Horoscoop van morgen
- Leefstijl: Horoscoop van gisteren
- Geld: Horoscoop van vandaag
- Geld: Horoscoop van morgen
- Geld: Horoscoop van gisteren
Wekelijkse horoscoop- Algemeen Wekelijks Horoscoop¶
- Geld en Investeringen: Wekelijkse Update
- Communicatie: Wekelijkse Update
- Vriendschap: Wekelijkse Update
- Leefstijl: Wekelijkse Update
Maandelijkse Horoscoop¶
- Algemeen Maandelijkse Horoscoop
- Geld: Maandelijkse Update
- Communicatie: Maandelijkse Update
- Vriendschap: Maandelijkse Update
- Leefstijl: Maandelijkse Update
Jaarlijks Horoscoop¶
- Algemeen Jaarlijks Horoscoop
- Carrière: Jaarlijks
- Gezondheid: Jaarlijks
- Geld: Jaarlijks
- Communicatie: Jaarlijks
- Vriendschap: Jaarlijks
- Leefstijl: Jaarlijks
Liefdes Horoscoop¶
- Enkelen: Liefde van Gisteren
- Enkelen: Liefde Vandaag
- Enkelen: Liefde Morgen
- Relaties: Liefde van Gisteren
- Relaties: Liefde Vandaag
- Relaties: Liefde Morgen
- Enkelen: Liefde Wekelijks
- Relaties: Liefde Wekelijks
- Enkelen: Liefde Maandelijks
- Relaties: Liefde Maandelijks
Planetair, Aspect, Transit en Huizen Rapporten- Planetaire dagelijkse secties¶
- Planetaire wekelijkse secties
- Planetaire maandelijkse secties
- Planetaire jaarlijkse secties
- Planetaire dagelijkse overzicht (algemeen)
- Planetaire wekelijkse overzicht (algemeen)
- Planetaire maandelijkse overzicht (algemeen)
- Planetaire jaarlijkse overzicht (algemeen)
- Aspecten dagelijkse secties
- Aspecten wekelijkse secties
- Aspecten maandelijkse secties
- Aspecten jaarlijkse secties
- Aspecten dagelijkse overzicht (algemeen)
- Aspecten wekelijkse overzicht (algemeen)
- Aspecten maandelijkse overzicht (algemeen)
- Aspecten jaarlijkse overzicht (algemeen)
- Transits dagelijkse secties
- Transits wekelijkse secties
- Transits maandelijkse secties
- Transits jaarlijkse secties
- Transits dagelijkse overzicht (algemeen)
- Transits wekelijkse overzicht (algemeen)
- Transits maandelijkse overzicht (algemeen)
- Transits jaarlijkse overzicht (algemeen)
- Huis dagelijkse secties
- Huis wekelijkse secties- Maandelijkse secties voor het huis
- Jaarlijkse secties voor het huis
- Dagelijks overzicht van het huis (algemeen)
- Wekelijk overzicht van het huis (algemeen)
- Maandelijks overzicht van het huis (algemeen)
- Jaarlijks overzicht van het huis (algemeen)
- Dagelijkse secties voor planeten en huizen
- Wekelijkse secties voor planeten en huizen
- Maandelijkse secties voor planeten en huizen
- Jaarlijkse secties voor planeten en huizen
- Dagelijks overzicht van planeten en huizen (algemeen)
- Wekelijk overzicht van planeten en huizen (algemeen)
- Maandelijks overzicht van planeten en huizen (algemeen)
- Jaarlijks overzicht van planeten en huizen (algemeen)
Beschrijvingen van de zonne tekens (Geen actuele rapporten)¶
Deze /api/v1/horoscope/sign/* endpoints retourneren beschrijvende archetype betekenissen, niet actuele astrologische rapporten. Gebruik /api/v1/horoscope/reports/* voor het genereren van actuele rapporten.- Persoonlijkheid ontdekken - Communicatiestijl - Vriendschap en affiniteiten - Liefde en verleiding - Leefstijl en esthetiek - Gezondheid en vitaliteit - Spiritualiteit en zielsentiteit - Schaduwpatronen - Carrière - Geld - Ouder en kind
Compatibiliteit en Encyclopedie¶
- Carrière compatibiliteit
- Vriendschapscompatibiliteit
- Liefdescompatibiliteit
- Astrologische aspecten
- Astrologische huizen
- Astrologische terugkeer
- Volledig astrologisch glossarium
- Informatie over planeten
- Planeten in huizen
- Effecten van Mercurius retrograde
- Effecten van Saturnus terugkeer
Ideaal voor¶
- Astrologie mobiele en web apps
- Gepersonaliseerde dagelijkse rapport feeds en nieuwsbrieven
- Compatibiliteit en relatie producten
- Wellness, coaching en spirituele dashboards
- Enterprise integraties die deterministische herhaalbaarheid vereisen
Aangedreven door NumerologyAPI.com