Zum Inhalt

Übersicht über die API für Horoskopberichte

Erstellen Sie astrologische Produkte auf einer deterministischen Engine, die auf der Swiss Ephemeris basiert und für Produktionsanwendungen entwickelt wurde.

Engine Qualität Redaktionsmodell Modi Berichtssprache

Diese API unterstützt zwei hochwertige Berichtsmodi:

  • Public mode für stabile, zeichenbasierte Ausgaben im großen Maßstab.
  • Personalized mode für redaktionsbasierte Berichte mit Geburtsdaten, die tiefere Vektoren (Häuser, Aspekte, Zeitdynamiken) berücksichtigen.

Sprachhinweis: Die Engine-basierten Endpunkte /api/v1/horoscope/reports/* unterstützen derzeit nur Englisch (lang=en). Nicht-Berichts-Endpunkte können translator-helper Sprachoptionen unterstützen, wie in der Dokumentation angegeben.

Klarheit der Antwort des Tierkreis-Systems

Wenn Sie zodiac_system: "tropical" auswählen, bleibt die Berichtsberechnung tropisch. Wenn Sie zodiac_system: "sidereal" auswählen, bleibt die Berichtsberechnung sideral.

Wenn kein zodiac_system im Anfragetext angegeben wird, verwendet die Engine standardmäßig tropical.

Sie können auch weiterhin tropische, siderale und ayanamsa-bezogene Felder in den Antwortmetadaten sehen, unabhängig vom gewählten Modus.Diese Felder werden nur für den Vergleich, die Transparenz und die Überwachung zurückgegeben. Sie beeinflussen oder ändern die tatsächlichen Berechnungen des ausgewählten Sternbildsystems nicht.

Tägliche App UI-Statistiken im Fokus

Die Haupt-täglichen, personalisierten Endpunkte stellen umfassende, benutzerfreundliche Statistiken bereit (data.daily_personalized_stats).

App UI Statistiken Aktivierung Payload Chart Packs

Personalisierte tägliche Statistiken umfassen:

  • overall_pulse
  • archetype_scores
  • harmony_discord
  • elemental_balance
  • momentum_channels
  • confidence pro Block

Verwenden Sie daily_stats_detail: "full" | "compact", um die Payload-Dichte für mobile/Web-Clients zu steuern.

Architektur

Vollständige Engine-Architektur

Vollständige Horoskop-Engine-Architektur

Anforderung-zu-Antwort-Architektur

Horoskop-Anforderung-zu-Antwort-Architektur

Laufzeit-Aufschlüsselung

Der Produktions-Horoskop-Stack folgt einer deterministischen Pipeline:1. API-Gateway validiert Authentifizierung, Quota und Request-Richtlinien. 2. FastAPI-Anwendung validiert den Vertrag und prüft den Cache. 3. HoroscopeService löst Signatur, Zeitraum, Ephemeris-Konfiguration und Modus auf. 4. EphemerisEngine berechnet Positionen, Aspekte, Häuser, Horoskop. 5. AggregationEngine extrahiert Zeitraum-Ereignisse, Metriken und rangierte Treiber. 6. InterpretationEngine ordnet Faktor-Stapel der redaktionellen Ausgabe mit Nachverfolgbarkeit zu. 7. Die Antwort wird zusammengestellt, mit Metadaten verpackt und zwischengespeichert.

Diese Architektur ermöglicht reproduzierbare Ausgaben für identische Payloads, während sie gleichzeitig eine tiefe Personalisierung für Premium-App-Erlebnisse ermöglicht.

Vertrauensmodell: Geschlossener Kern + Open Source Lite

Unser Hauptmotor ist Open-Source und für deterministische Berichte im Unternehmensumfeld, Premium-Redaktionsschichten und Produktionszuverlässigkeit optimiert.

Um Transparenz und Entwicklertrauen zu fördern, pflegen wir auch eine robuste, leichte Open-Source-Engine:

  • OpAstro-Website: opastro.com
  • OpAstro-Quellcode: github.com/dakidarts/opastro
  • OpAstro-Paket: pypi.org/project/opastroVerwenden Sie OpAstro, um die Qualität des Motors schnell zu bewerten, und skalieren Sie dann auf die Enterprise-Routen der NumerologyAPI, um detailliertere Berichtsfunktionen, eine umfassendere Endpunktabdeckung und verwaltete Produktionsoperationen zu ermöglichen.

So geht es

Schnellstart: Personalisierte tägliche + App-Statistiken

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"
}'

Dies gibt einen aktuellen Tagesbericht sowie data.daily_personalized_stats für App-Karten und Trendmodule zurück.

Leitfaden zur Routenauswahl

Ziel Empfohlene Endpoint-Familie
Allgemeiner Tagesbericht basierend auf Zeichen /horoscope/reports/today, /horoscope/reports/tomorrow, /horoscope/reports/yesterday
Personalisierter Tagesbericht + App-Statistik-Karten Hauptrouten mit birth_time, Koordinaten und daily_stats_detail
Periodische allgemeine Berichte /horoscope/reports/weekly, /horoscope/reports/monthly, /horoscope/reports/yearly
Abschnittsspezifische Berichte (Karriere, Gesundheit, Finanzen, Kommunikation, Freundschaft, Lebensstil, Liebe) Routen für Abschnitte über Perioden
Editorial-Berichte, die sich auf Planeten konzentrieren Planet-Routen
Editorial-Berichte, die sich auf Aspekte konzentrieren Aspekt-Routen
Editorial-Berichte, die sich auf Transite konzentrieren Transit-Routen
Personalisierte Berichte, die sich auf Häuser konzentrieren Haus-Routen
Personalisierte Berichte, die sich auf Planeten und Häuser konzentrieren Planet-Haus-Routen
Detaillierte Geburtshoroskop + Wheel-Artefakte Geburtshoroskop-Routen

Endpoint-Karte

Verwenden Sie diese Karte, um direkt zur exakten Endpoint-Familie zu gelangen, die Ihr Produkt benötigt.

Geburtshoroskop und Grundlagen

Tageshoroskop

Wöchentliches Horoskop

Monatshoroskop

Jahreshoroskop

Liebeshoroskop

Planetarische, Aspekt-, Transit

Beschreibungen der Sternzeichen (Nicht Live-Berichte)

Diese Endpunkte /api/v1/horoscope/sign/* liefern deskriptive Archetypen-Bedeutungen der Sternzeichen, nicht Live-astrologische Berichte. Verwenden Sie /api/v1/horoscope/reports/* für die Generierung von Live-Berichten. - Persönlichkeit analysieren - Kommunikationsstil - Freundschaft und Affinitäten - Liebe und Verführung - Lebensstil und Ästhetik - Gesundheit und Vitalität - Spiritualität und Lebenszweck - Schattenmuster - Beruf - Finanzen - Eltern und Kind

Kompatibilität und Enzyklopädie

Ideal für

  • Astrologische mobile und Web-Anwendungen
  • Personalisierte tägliche Berichts-Feeds und Newsletter
  • Produkte zur Kompatibilität und Beziehung
  • Wellness-, Coaching- und spirituelle Dashboards
  • Unternehmensintegrationen, die deterministische Wiederholbarkeit benötigen

Powered by NumerologyAPI.com