Vai al contenuto

Panoramica dell'API per i Report di Astrologia

Costruisci prodotti astrologici su un motore deterministico basato sull'ephemeride svizzera, progettato per applicazioni di produzione.

Qualità del Motore Modello Editoriale Modalità Lingua dei Report: Tutte le 26 lingue

Questa API supporta due modalità di report ad alto valore:

  • Public mode per l'output stabile basato sui segni su larga scala.
  • Personalized mode per report editoriali consapevoli dei dati di nascita con vettori più approfonditi (case, aspetti, dinamiche temporali).

Nota sulla lingua: gli endpoint supportati dal motore /api/v1/horoscope/reports/* e /api/v1/birth-chart supportano tutte le 26 lingue — le risposte non in inglese vengono tradotte al volo dall'helper del traduttore (LibreTranslate come predefinito; DeepL BYOK, MyMemory o Google selezionabili per richiesta).

Chiarezza della Risposta del Sistema Zodiacale

Quando selezioni zodiac_system: "tropical", il calcolo del report rimane tropicale. Quando selezioni zodiac_system: "sidereal", il calcolo del report rimane siderale.

Se non viene fornito alcun zodiac_system nel corpo della richiesta, il motore utilizza di default tropical.

Potresti comunque vedere campi relativi a tropicale, siderale e ayanamsa nei metadati della risposta, indipendentemente dalla modalità selezionata.Questi campi vengono restituiti esclusivamente per scopi di confronto, trasparenza e osservabilità. Non modificano i calcoli effettivi del report per il sistema zodiacale selezionato.

Statistiche dell'interfaccia utente giornaliera

I principali endpoint personalizzati espongono statistiche ricche e adatte all'interfaccia utente in data.daily_personalized_stats.

Statistiche dell'interfaccia utente Attivazione Payload Pacchetti di grafici

Le statistiche giornaliere personalizzate includono:

  • overall_pulse
  • archetype_scores
  • harmony_discord
  • elemental_balance
  • momentum_channels
  • confidence per blocco

Utilizza daily_stats_detail: "full" | "compact" per controllare la densità del payload per i client mobile/web.

Architettura

Architettura dell'intero motore

Architettura completa dell'engine oroscopico

Architettura Richiesta-Risposta

Architettura richiesta-risposta oroscopica

Scomposizione del runtime

Lo stack oroscopico di produzione segue un pipeline deterministico:1. API Gateway valida l'autenticazione, i limiti e le politiche di richiesta. 2. L'applicazione FastAPI convalida il contratto e controlla la cache. 3. HoroscopeService risolve firma, finestra temporale, configurazione dell'ephemeris e modalità. 4. EphemerisEngine calcola posizioni, aspetti, case e segno ascendente. 5. AggregationEngine estrae eventi del periodo, metriche e driver ordinati. 6. InterpretationEngine mappa i gruppi di fattori all'output editoriale con tracciabilità. 7. La risposta viene assemblata, avvolta con metadati ed è memorizzata nella cache.

Questa architettura fornisce risultati ripetibili per payload identici, pur consentendo una personalizzazione profonda per le esperienze di applicazioni a pagamento.

Modello di Fiducia: Core Chiuso + Open Source Leggero

Il nostro motore principale è open-source e ottimizzato per report deterministici di livello aziendale, livelli editoriali premium e affidabilità in produzione.

Per promuovere la trasparenza e la fiducia degli sviluppatori, manteniamo anche un robusto motore open-source leggero:

  • Sito web OpAstro: opastro.com
  • Sorgente OpAstro: github.com/dakidarts/opastro
  • Pacchetto OpAstro: pypi.org/project/opastroUtilizza OpAstro per valutare rapidamente la qualità del motore, quindi passa alle route enterprise di NumerologyAPI per report più ricchi, una copertura più ampia degli endpoint e operazioni di produzione gestite.

Inizia Qui

Guida rapida: Rapporto giornaliero personalizzato + statistiche dell'app

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

Questo restituisce un rapporto giornaliero in tempo reale, oltre a data.daily_personalized_stats per le schede e i moduli di tendenza dell'app.

Guida alla selezione delle route| Obiettivo | Famiglia di Endpoint Raccomandata |

|---|---| | Rapporto giornaliero basato sul segno solare | /horoscope/reports/today, /horoscope/reports/tomorrow, /horoscope/reports/yesterday | | Rapporto giornaliero personalizzato + schede con statistiche dell'app | Percorsi principali giornalieri con birth_time, coordinate e daily_stats_detail | | Rapporti generali periodici | /horoscope/reports/weekly, /horoscope/reports/monthly, /horoscope/reports/yearly | | Rapporti specifici per sezione (carriera, salute, denaro, comunicazione, amicizia, stile di vita, amore) | Percorsi per sezione su diversi periodi | | Rapporti editoriali focalizzati sui pianeti | Percorsi planetari | | Rapporti editoriali focalizzati sugli aspetti | Percorsi sugli aspetti | | Rapporti editoriali focalizzati sui transiti | Percorsi sui transiti | | Rapporti personalizzati per casa | Percorsi per casa | | Rapporti personalizzati pianeta-casa | Percorsi pianeta-casa | | Grafico natale dettagliato + artefatti del cerchio | Percorsi per il grafico natale |

Mappa degli Endpoint

Utilizza questa mappa per accedere direttamente alla famiglia di percorsi esatta di cui ha bisogno il tuo prodotto.

Grafico Natale e Fondamenti

Oroscopo Quotidiano- Oroscopo di ieri

Oroscopo settimanale- Oroscopo Settimanale Generale

Oroscopo Mensile

Oroscopo Annuale

Oroscopo Amoroso

Rapporti Planetari, Aspetti, Transit e Case- Sezioni Planetarie Giornaliere

Descrizioni dei Segni Zodiacali (Non Report in Tempo Reale)

Questi endpoint /api/v1/horoscope/sign/* restituiscono significati archetipici del segno, non report astrologici in tempo reale. Utilizzare /api/v1/horoscope/reports/* per la generazione di report in tempo reale.- Personalità - Stile di Comunicazione - Amicizie e Affinità - Amore e Seduzione - Stile di Vita ed Estetica - Salute e Vitalità - Spiritualità e Missione Personale - Modelli Ombra - Carriera - Finanze - Genitorialità e Rapporti Familiari

Compatibilità ed Enciclopedia

Ideale per

  • App e applicazioni web astrologiche
  • Feed giornalieri personalizzati e newsletter
  • Prodotti di compatibilità e relazioni
  • Dashboard per benessere, coaching e spiritualità
  • Integrazioni aziendali che richiedono ripetibilità deterministica

Alimentato da NumerologyAPI.com