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

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/* attualmente supportano solo l'inglese (lang=en). Gli endpoint non relativi al report possono supportare opzioni di lingua per l'assistente di traduzione, ove documentato.

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