Przegląd API Raportów Horoskopowych¶
Twórz produkty astrologiczne na podstawie deterministycznego silnika napędzanego przez Swiss Ephemeris, przeznaczonego do aplikacji produkcyjnych.
Ten API obsługuje dwa tryby raportowania o wysokiej wartości:
Public modedla stabilnego, opartego na znakach wyjścia w dużym skali.Personalized modedla raportów redakcyjnych uwzględniających dane urodzeniowe z głębszymi wektorami (domy, aspekty, dynamika czasu).
Uwaga językowa: punkty końcowe silnika obsługujące
/api/v1/horoscope/reports/*obecnie obsługują tylko język angielski (lang=en). Punkty końcowe niezwiązane z raportowaniem mogą obsługiwać opcje języka pomocniczego tłumacza, zgodnie z dokumentacją.
Jasność Odpowiedzi Systemu Zodiaku¶
Gdy wybierzesz zodiac_system: "tropical", obliczenia raportu pozostają tropikalne. Gdy wybierzesz zodiac_system: "sidereal", obliczenia raportu pozostają siderealne.
Jeśli żaden z zodiac_system nie zostanie podany w ciele żądania, silnik domyślnie użyje tropical.
Niezależnie od wybranego trybu, możesz nadal zobaczyć pola związane z tropikalnym, siderealnym i ayanamsą w metadanych odpowiedzi. Te pola są zwracane wyłącznie w celu porównania, przejrzystości i monitoringu. Nie wpływają one na rzeczywiste obliczenia raportu dla wybranego systemu astrologicznego.
Codzienne statystyki interfejsu użytkownika aplikacji¶
Główne codzajne punkty końcowe personalizowane udostępniają bogate, przyjazne interfejsowi statystyki w data.daily_personalized_stats.
Personalizowane codzajne statystyki obejmują:
overall_pulsearchetype_scoresharmony_discordelemental_balancemomentum_channelsconfidencena blok
Użyj daily_stats_detail: "full" | "compact", aby kontrolować gęstość payload dla klientów mobilnych/internetowych.
Architektura¶
Pełna architektura silnika¶

Architektura żądania-odpowiedzi¶

Podział na działanie¶
Produkcyjna architektura horoskopowa opiera się na deterministycznej sekwencji:1. API Gateway weryfikuje autoryzację, limity i politykę żądania. 2. Aplikacja FastAPI weryfikuje kontrakt i sprawdza pamięć podręczną. 3. HoroscopeService rozwiązuje kwestie znaku, okna okresu, konfiguracji ephemeris oraz tryb. 4. EphemerisEngine oblicza pozycje, aspekty, domy i wschodni znak. 5. AggregationEngine wyodrębnia wydarzenia okresu, metryki i najważniejsze czynniki. 6. InterpretationEngine mapuje stany czynników na wynik editorialny z możliwością śledzenia. 7. Odpowiedź jest tworzona, owinięta metadanymi i zapisywana w pamięci podręcznej.
Ta architektura zapewnia powtarzalne wyniki dla identycznych payloadów, jednocześnie umożliwiając głębokie personalizowanie doświadczeń użytkowników płatnych aplikacji.
Model Zaufania: Zamknięte Jądro + Lekki Open Source¶
Nasze główne jądro jest oparte na kodzie źródłowym i zoptymalizowane dla raportów deterministycznych, wysokiej jakości, warstw editorialnych oraz niezawodności w środowisku produkcyjnym.
Aby promować przejrzystość i zaufanie programistów, utrzymujemy również solidny, lekki silnik open source:
- Strona OpAstro: opastro.com
- Źródło OpAstro: github.com/dakidarts/opastro
- Pakiet OpAstro: pypi.org/project/opastroWykorzystaj OpAstro, aby szybko ocenić jakość silnika, a następnie rozszerz do korporacyjnych tras NumerologyAPI, aby uzyskać bogatsze warstwy raportów, szerszy zakres punktów końcowych i zarządzane operacje produkcyjne.
Zacznij od tego¶
- Szczegółowa analiza silnika: Wprowadzenie do naszego silnika horoskopu
- Notatki z wersji: Numerology API v1.0.0 Changelog
- Kluczowe trasy:
- Dzisiejszy horoskop
- Horoskop jutra
- Horoskop wczoraj
- Horoskop urodzinowy
- Pełna mapa urodzeniowa
Szybki start: Spersonalizowany raport dzienny + statystyki aplikacji¶
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"
}'
Zwraca aktualny raport dzienny oraz data.daily_personalized_stats dla kart i modułów trendów aplikacji.
Przewodnik po wyborze tras| Cel | Zalecana rodzina endpointów |¶
|---|---| | Codzienne raporty oparte na znaku | /horoscope/reports/today, /horoscope/reports/tomorrow, /horoscope/reports/yesterday | | Personalizowane codzienne raporty + karty statystyk aplikacji | Główne routy z birth_time, współrzędnymi i daily_stats_detail | | Okresowe ogólne raporty | /horoscope/reports/weekly, /horoscope/reports/monthly, /horoscope/reports/yearly | | Raporty specyficzne dla sekcji (kariera, zdrowie, pieniądze, komunikacja, przyjaźń, styl życia, miłość) | Routy dla sekcji w różnych okresach | | Raporty redakcyjne skoncentrowane na planetach | Routy planetarne | | Raporty redakcyjne skoncentrowane na aspektach | Routy dla aspektów | | Raporty redakcyjne skoncentrowane na tranzytach | Routy dla tranzytów | | Personalizowane raporty zorientowane na dom | Routy dla domów | | Personalizowane raporty planet-dom | Routy planet-dom | | Pełna karta urodzeniowa + artefakty koła | Routy dla karty urodzeniowej |
Mapa Endpointów¶
Użyj tej mapy, aby bezpośrednio przejść do dokładnej rodziny rout, której potrzebuje Twój produkt.
Karta Urodzeniowa i Podstawy¶
Codzienny Horoskop- Dzisiejszy Horoskop¶
- Dzisiejszy
- Jutrzejszy
- Ogólny Dzienny (Sekcja Pierwsza)
- Ogólny Dzienny Jutro (Sekcja Pierwsza)
- Ogólny Dzienny Wczoraj (Sekcja Pierwsza)
- Zawodowy Dzienny (Sekcja Pierwsza)
- Zawodowy Dzienny Jutro (Sekcja Pierwsza)
- Zawodowy Dzienny Wczoraj (Sekcja Pierwsza)
- Zdrowie Dziennie (Sekcja Pierwsza)
- Zdrowie Dziennie Jutro (Sekcja Pierwsza)
- Zdrowie Dziennie Wczoraj (Sekcja Pierwsza)
- Komunikacja Dziennie
- Komunikacja Dziennie Jutro
- Komunikacja Dziennie Wczoraj
- Przyjaźń Dziennie
- Przyjaźń Dziennie Jutro
- Przyjaźń Dziennie Wczoraj
- Styl Życia Dziennie
- Styl Życia Dziennie Jutro
- Styl Życia Dziennie Wczoraj
- Finanse Dziennie
- Finanse Dziennie Jutro
- Finanse Dziennie Wczoraj
Tygodniowy Horoskop- Ogólny Horoskop Tygodniowy¶
- Finanse i Inwestycje - Horoskop Tygodniowy
- Komunikacja - Horoskop Tygodniowy
- Przyjaźń - Horoskop Tygodniowy
- Styl Życia - Horoskop Tygodniowy
Miesięczny Horoskop¶
- Ogólny Miesięczny Horoskop
- Finanse - Miesięczny Horoskop
- Komunikacja - Miesięczny Horoskop
- Przyjaźń - Miesięczny Horoskop
- Styl Życia - Miesięczny Horoskop
Roczny Horoskop¶
- Ogólny Roczny Horoskop
- Kariera - Roczny Horoskop
- Zdrowie - Roczny Horoskop
- Finanse - Roczny Horoskop
- Komunikacja - Roczny Horoskop
- Przyjaźń - Roczny Horoskop
- Styl Życia - Roczny Horoskop
Horoskop Miłosny¶
- Relacje Singlowe - Minione
- Relacje Singlowe - Dziś
- Relacje Singlowe - Jutro
- Relacje Par - Minione
- Relacje Par - Dziś
- Relacje Par - Jutro
- Relacje Singlowe - Tygodniowe
- Relacje Par - Tygodniowe
- Relacje Singlowe - Miesięczne
- Relacje Par - Miesięczne
Raporty Planetarne, Aspekty, Przejścia i Domy- Dziennie dotyczące planet¶
- Tygodniowe sekcje dotyczące planet
- Miesięczne sekcje dotyczące planet
- Roczne sekcje dotyczące planet
- Ogólny przegląd dotyczący planet (dzienne)
- Ogólny przegląd dotyczący planet (tygodniowy)
- Ogólny przegląd dotyczący planet (miesięczny)
- Ogólny przegląd dotyczący planet (roczny)
- Dziennie dotyczące aspektów
- Tygodniowe sekcje dotyczące aspektów
- Miesięczne sekcje dotyczące aspektów
- Roczne sekcje dotyczące aspektów
- Ogólny przegląd dotyczący aspektów (dzienne)
- Ogólny przegląd dotyczący aspektów (tygodniowy)
- Ogólny przegląd dotyczący aspektów (miesięczny)
- Ogólny przegląd dotyczący aspektów (roczny)
- Dziennie dotyczące transz
- Tygodniowe sekcje dotyczące transz
- Miesięczne sekcje dotyczące transz
- Roczne sekcje dotyczące transz
- Ogólny przegląd dotyczący transz (dzienne)
- Ogólny przegląd dotyczący transz (tygodniowy)
- Ogólny przegląd dotyczący transz (miesięczny)
- Ogólny przegląd dotyczący transz (roczny)
- Dziennie dotyczące domów
- Tygodniowe sekcje dotyczące domów- Miesięczne sekcje dla domu
- Roczne sekcje dla domu
- Dzienne podsumowanie dla domu (Ogólne)
- Tygodniowe podsumowanie dla domu (Ogólne)
- Miesięczne podsumowanie dla domu (Ogólne)
- Roczne podsumowanie dla domu (Ogólne)
- Dzienne sekcje dla planet i domów
- Tygodniowe sekcje dla planet i domów
- Miesięczne sekcje dla planet i domów
- Roczne sekcje dla planet i domów
- Dzienne podsumowanie dla planet i domów (Ogólne)
- Tygodniowe podsumowanie dla planet i domów (Ogólne)
- Miesięczne podsumowanie dla planet i domów (Ogólne)
- Roczne podsumowanie dla planet i domów (Ogólne)
Opisy znaków zodiaku (Nie są to aktualne raporty)¶
Te punkty końcowe /api/v1/horoscope/sign/* zwracają opisowe znaczenia archetypów znaków, a nie aktualne raporty astrologiczne. Użyj /api/v1/horoscope/reports/* do generowania aktualnych raportów.- Określ swój typ osobowości - Styl komunikacji - Przyjaźń i afinityty - Miłość i namiętność - Styl życia i estetyka - Zdrowie i energia życiowa - Spiritualność i misja duszy - Schematy cienia - Kariera - Pieniądze - Rodzina i dziecko
Kompatybilność i Encyklopedia¶
- Kompatybilność w karierze
- Kompatybilność w przyjaźni
- Kompatybilność w miłości
- Aspekty astrologiczne
- Dom Astrologiczny
- Powroty Astrologiczne
- Kompletna Encyklopedia Astrologiczna
- Informacje o planetach
- Planety w domach
- Skutki Merkurego w odwrocie
- Skutki Saturnu
Najlepsze dla¶
- Aplikacji mobilnych i webowych z astrologią
- Personalizowanych dziennych raportów i newsletterów
- Produktów związanych z kompatybilnością i relacjami
- Dashboardów wellness, coachingu i duchowości
- Integracji korporacyjnych wymagających deterministycznej powtarzalności
Napędzane przez NumerologyAPI.com