Espansione Numerologia + Espansione Oracolo v1.0.0 Registro Modifiche Unificato¶

Data di rilascio: 2026-04-12 Versione: v1.0.0 Ambito: Rilascio completo della piattaforma che copre The Numerology API, Espansione Oracolo: inclusa la distribuzione degli endpoint estesi, la migrazione del rapporto oracolico basato sul motore, la normalizzazione delle richieste/risposte, la coerenza della documentazione, la validazione multilingue e le linee guida per l'integrazione in produzione.

Panoramica¶

v1.0.0 è un rilascio di produzione importante sulla piattaforma API Dakidarts. Integra due grandi progetti in un unico rollout coordinato:

1. Espansione Numerologia
2. Aggiunge la completa superficie numerologica estesa.
3. Amplia la copertura temporale/ciclica con settimana personale e giorno/settimana/mese/anno universali.
4. Introduce endpoint più approfonditi per l'analisi spirituale, relazionale, dell'identità e delle ombre.
5. Completa la coerenza della documentazione, gli esempi di risposta e la validazione multilingue.2. Espansione dell'Horoscope
6. Completa la migrazione principale della generazione di report oroscopici al motore Swiss Ephemeris interno.
7. Standardizza i percorsi dei report supportati dal motore sotto /api/v1/horoscope/reports/*.
8. Aggiunge una copertura completa delle sezioni su base giornaliera, settimanale, mensile e annuale.
9. Introduce suite di report periodizzati per pianeti, aspetti, transiti e case.
10. Migliora la coerenza dei payload, il comportamento di personalizzazione, gli alias di compatibilità e la parità della documentazione.

Questo changelog è destinato a fungere da fonte unica di informazioni per gli integratori, le revisioni interne, il supporto, la pianificazione delle migrazioni e la comunicazione alle parti interessate.

Punti Salienti a Livello di Piattaforma¶

Cosa offre v1.0.0 in tutta la piattaforma- Rilascio di produzione v1.0.0 sia per l'API Numerology che per l'API Horoscope.¶

• Ampia espansione dell'area degli endpoint nei prodotti numerologia e oroscopo.
• Completamento della migrazione del motore di calcolo dell'oroscopo per i principali flussi di report.
• Completamento del percorso di rilascio Extended Numerology.
• Implementazione migliorata dei modelli di richiesta POST-first strutturati per le rotte oroscopiche aggiornate.
• Maggiore supporto per i payload di risposta ricchi, wrapper aziendali e coerenza dei metadati.
• Maggiore coerenza della documentazione tra la documentazione pubblica ed i payload di esempio.
• Validazione multilingue di successo per gli endpoint numerologia estesi.
• Migliore chiarezza delle rotte, gestione della compatibilità e guida alla migrazione per i clienti in produzione.
• Supporto ampliato per i calcoli personalizzati dove vengono forniti vettori di nascita e campi di richiesta avanzati.
• Maggiore chiarezza operativa riguardo a fuso orario, sistema zodiacale, ayanamsa, sistemi di case e comportamento dei nodi nei flussi di richiesta dell'oroscopo.

Riepilogo della Composizione del Rilascio### Espansione della Numerologia¶

• Aggiunte nuove famiglie di endpoint: 23
• Aggiunte operazioni combinate (GET/POST): 41
• Eseguite richieste di validazione/smoke: 205
• Documentato successo multilingue di smoke: 100.0%
• Modello di rilascio esteso: additive, senza deprecazioni formali nella nuova suite

Espansione dell'Oroscopo¶

• Grandi report migrati al motore interno
• Aggiunte nuove suite di report su:
• planetari
• aspetti
• transiti
• casa
• pianeta-casa
• Stabilito namespace del report canonico sotto:
• /api/v1/horoscope/reports/*
• Mantenute più route legacy come alias di compatibilità nascoste mentre la documentazione pubblica prosegue con i percorsi canonici

Parte I — API Numerologia v1.0.0¶

Punti salienti dell'Espansione della Numerologia- Aggiunta la documentazione completa della Numerologia Estesa nella sezione di documentazione estesa.¶

• Aggiunta e completata la funzionalità Settimana Personale, con piena corrispondenza GET/POST e supporto per payload di risposta ricchi.
• Aggiunte e completate le Estensioni del Ciclo Universale:
• Giorno Universale
• Settimana Universale
• Mese Universale
• Anno Universale
• Standardizzate la documentazione degli endpoint estesi con tabelle complete di parametri, opzioni, esempi di risposta e collegamenti agli endpoint correlati.
• Confermata la copertura multilingue per i test su en, es, de, fr, pt con successo al 100% per le operazioni estese.
• Chiarito il modello di accesso: gli endpoint estesi sono disponibili solo sulla piattaforma principale e non sono attualmente supportati tramite gateway RapidAPI.

Espansione Numerologica — Nuovi Endpoint Aggiunti¶

Questa release aggiunge 23 famiglie di endpoint estese e 41 operazioni (GET/POST combinate).

A) Endpoint per Cicli e Timing| Endpoint | Metodi | Percorso |¶

|---|---|---| | Settimana Personale | GET, POST | /api/v1/personal-week | | Anno Universale | GET, POST | /api/v1/universal-year | | Mese Universale | GET, POST | /api/v1/universal-month | | Settimana Universale | GET, POST | /api/v1/universal-week | | Giorno Universale | GET, POST | /api/v1/universal-day | | Mappa Energetica Mensile | GET, POST | /api/v1/monthly-energy-heatmap | | Calendario Date di Attenzione | GET, POST | /api/v1/caution-dates-calendar |

B) Endpoint per l'Identità e l'Analisi del Nome¶

C) Endpoint per l'Analisi Spirituale e dell'Ombra| Endpoint | Metodi | Percorso |¶

|---|---|---| | Lettura della Frequenza Aura | GET, POST | /api/v1/aura-frequency-reading | | Numerologia del Chakra | GET, POST | /api/v1/chakra-numerology | | Modelli della Vita Passata | GET, POST | /api/v1/past-life-patterns | | Numero del Lavoro Nero | GET, POST | /api/v1/shadow-work-number | | Lettura del Contratto dell'Anima | GET, POST | /api/v1/soul-contract-reading | | Indicatore della Connessione Spirituale | POST | /api/v1/soul-connection-indicator | | Lettura dei Doni Spirituali | GET, POST | /api/v1/spiritual-gifts-reading | | Lettura dell'Equilibrio Sacro | GET, POST | /api/v1/sacred-balance-reading |

D) Endpoint per le Dinamiche Relazionali¶

API di Numerologia — Endpoint Aggiornati e Corretti¶

A) Superfici Core Estese Completate¶

Le seguenti superfici, introdotte in questa fase di rilascio, sono state completate integralmente con validazione delle richieste e output ricco di significato:

• GET /api/v1/personal-week
• POST /api/v1/personal-week
• GET /api/v1/universal-year
• POST /api/v1/universal-year
• GET /api/v1/universal-month
• POST /api/v1/universal-month
• GET /api/v1/universal-week
• POST /api/v1/universal-week
• GET /api/v1/universal-day
• POST /api/v1/universal-day### B) Correzioni per la Stabilità Applicate Durante la Validazione Iniziale Cinque operazioni che inizialmente producevano 422 con input generati sono state stabilizzate per una copertura di test simile all'ambiente di produzione e ora restituiscono risposte positive in più lingue:

• POST /api/v1/brand-name-compare
• GET /api/v1/caution-dates-calendar
• POST /api/v1/caution-dates-calendar
• GET /api/v1/monthly-energy-heatmap
• POST /api/v1/monthly-energy-heatmap

C) Regole di Validazione Pratiche Rafforzate¶

Le seguenti restrizioni sono state ulteriormente definite e chiarite durante le fasi di validazione e documentazione: - Il confronto di marchi richiede almeno due voci in names[].- Gli input per il calendario e la mappa termica utilizzano il formato YYYY-MM.- Attenzione: le date indicate in top_n rimangono limitate all'intervallo 1..31.- I payload dei client beneficiano di una validazione preliminare prima della trasmissione per ridurre gli errori evitabili relativi a 422 o agli errori a livello di formattazione.

D) Correzioni per la Coerenza tra Documentazione e OpenAPI¶

Tutte le documentazioni estese sono state normalizzate per garantire la coerenza nell'integrazione: - completare le tabelle dei parametri per ogni metodo- dettagli opzione parametro- pattern, intervalli, valori predefiniti e campi di oggetti nidificati

---- Esempi di risposte ricche basati su payload generati da test- note standardizzate sull accesso e disponibilità

---- pulsanti CTA per il pannello di controllo, sezioni informative e piè di pagina relativi agli endpoint correlati

---¶

Numerology API — Riepilogo della Verifica QA¶

Artefatti di validazione per la suite numerologica estesa:

• File di riepilogo: 23
• Operazioni testate: 41
• Richieste eseguite in totale: 205
• Tasso di successo complessivo: 100.0%
• Successo per lingua:
• en — 100%
• es — 100%
• de — 100%
• fr — 100%
• pt — 100%

Questa release conclude il ciclo di lancio della suite numerologica estesa, garantendo la fiducia nella validazione su tutto l'insieme di lingue documentato.

Numerology API — Deprecazioni¶

Per la release Numerology Extended v1.0.0, nessun endpoint nella superficie estesa è formalmente deprecato.

Numerology API — Modifiche Incompatibili¶

Non vengono introdotte rimozioni di percorsi incompatibili sulla superficie numerologica estesa in questa release.

Tuttavia, gli integratori dovrebbero notare le seguenti aspettative a livello di rilascio:- Gli endpoint estesi non sono attualmente disponibili tramite RapidAPI. - I clienti che integrano gli endpoint estesi dovrebbero indirizzare direttamente l'host della piattaforma. - Alcuni nuovi endpoint sono disponibili solo con POST e non dovrebbero essere considerati equivalenti a GET.

Numerology API — Note sulla migrazione¶

1) Migrazione del canale di accesso¶

Gli endpoint estesi sono disponibili tramite l'accesso diretto alla piattaforma:

• URL base: https://api.numerologyapi.com
• Autenticazione:
• X-API-Key: YOUR_API_KEY
• oppure Authorization: Bearer YOUR_API_KEY

Gli endpoint estesi non sono attualmente supportati tramite gateway RapidAPI.

2) Linee guida per l'uso di GET vs POST¶

La maggior parte degli endpoint estesi supporta sia GET che POST con lo stesso intento di output.

Utilizzare:

• GET per chiamate basate su query semplici
• POST per strutture di payload più complesse, oggetti nidificati e coerenza SDK/backend

Gli endpoint che accettano solo POST in questa release includono:

• /api/v1/brand-name-compare
• /api/v1/relationship-composite
• /api/v1/relationship-healing-reading
• /api/v1/parent-child-numerology
• /api/v1/soul-connection-indicator

3) Regole di validazione dell'input lato client¶

È consigliata una prevalidazione lato client:- dob e target_date: YYYY-MM-DD - month: YYYY-MM - timezone_offset: stringa valida IANA per il fuso orario - top_n: intero nell'intervallo 1..31 - names[]: minimo di 2 voci per il confronto del marchio - context per l'allineamento della data: lunghezza massima 80, accettati alias normalizzati

4) Pattern per il Corpo della Richiesta Nidificato¶

Per gli endpoint di relazione e compatibilità, utilizzare oggetti nidificati espliciti come:

• person_a
• person_b
• parent
• child

Ogni oggetto dovrebbe includere i campi richiesti come:

• full_name
• dob

5) Gestione del Linguaggio e dei Metadati¶

Gli endpoint numerologici estesi supportano la renderizzazione di risposte multilingue tramite lang.

Impostazione linguistica supportata per la copertura verificata:

• en
• es
• de
• fr
• pt

Le risposte possono includere wrapper di metadati in stile aziendale:

• _enterprise
• _api_metadata_

I client dovrebbero preservare e analizzare questi campi quando utile per l'analisi della piattaforma, le informazioni sul piano o i metadati dell'endpoint.

6) Copertura del Ciclo Aggiunta di Nuovo¶

I client che utilizzavano in precedenza solo flussi per giorno/mese/anno possono ora estendere la logica dello schedule per coprire:- cicli personali settimanali tramite /api/v1/personal-week - superfici di tempistica collettiva tramite: - /api/v1/universal-day - /api/v1/universal-week - /api/v1/universal-month - /api/v1/universal-year

7) Fonte di Documentazione Autentica¶

Le pagine complete di integrazione a livello di endpoint per questa release sono mantenute nella sezione della documentazione estesa, inclusi le pagine indice e specifiche per ogni endpoint.

Numerology API — Lista di Controllo Consigliata per l'Aggiornamento¶

• Spostare le chiamate estese all'accesso diretto all'API in https://api.numerologyapi.com.
• Assicurarsi che i validatori di richiesta applicino formati data, mese e fuso orario.
• Aggiungere la gestione dei valori multilingue lang dove necessario.
• Aggiornare i client per analizzare in modo coerente _enterprise e _api_metadata_.
• Per gli endpoint nidificati, allineare i modelli di richiesta SDK alle chiavi oggetto richieste.
• Validare con fixture prima di promuovere alla produzione.
• Confermare che tutte le chiamate estese siano indirizzate al di fuori delle assunzioni dei client basate su RapidAPI.

Numerology API — Riepilogo Note di Rilascio¶

Numerology API v1.0.0 introduce la completa superficie numerologica estesa con l'espansione dei cicli settimanali e universali, analisi avanzate delle relazioni e spirituali, contratti di richiesta/risposta più ricchi e documentazione completamente sincronizzata, oltre alla parità dei test "smoke".# Parte II — Espansione dell'oroscopo v1.0.0

Punti salienti dell'Espansione dell'oroscopo¶

• Completata la migrazione dei principali flussi di report oroscopici al motore Swiss Ephemeris interno.
• Standardizzati gli endpoint di report aggiornati attorno alle richieste con corpo POST come prima.
• Aggiunta una copertura ampia delle sezioni in base al periodo, inclusi i periodi giornalieri, settimanali, mensili e annuali.
• Ristrutturati gli endpoint dei report planetari per periodo e sezione/panoramica.
• Rinominato l'endpoint del glossario dei pianeti per riflettere il suo comportamento informativo piuttosto che quello relativo al report.
• Ampliata la parità delle richieste di chart natale e rafforzata la validazione della forma della risposta.
• Normalizzate le risposte degli endpoint aggiornati, includendo il payload del motore e gli wrapper di metadati aziendali.
• Aggiornate le istanze di esempio nei documenti pubblici con parità JSON supportata.

Espansione dell'oroscopo — Nuovi Endpoint Aggiunti¶

A) Nuove Superfici e Assistenti¶

• GET /api/v1/horoscope/timezones

B) Suite dei Report Planetari (Superficie Periodizzata)¶

Sezioni (non generali):

• POST /api/v1/horoscope/reports/planetary/daily
• POST /api/v1/horoscope/reports/planetary/weekly
• POST /api/v1/horoscope/reports/planetary/monthly
• POST /api/v1/horoscope/reports/planetary/yearly

Panoramica (solo generale):

• POST /api/v1/horoscope/reports/planetary/daily/overview
• POST /api/v1/horoscope/reports/planetary/weekly/overview
• POST /api/v1/horoscope/reports/planetary/monthly/overview
• POST /api/v1/horoscope/reports/planetary/yearly/overview

L'ampliamento della copertura delle sezioni planetarie include anche le sezioni supportate dal motore, come:- communication - friendship - lifestyle - career - health - money - love_singles - love_couples

C) Suite di Report sugli Aspetti (Superficie Periodizzata)¶

Sezioni (non generali):

• POST /api/v1/horoscope/reports/aspects/daily
• POST /api/v1/horoscope/reports/aspects/weekly
• POST /api/v1/horoscope/reports/aspects/monthly
• POST /api/v1/horoscope/reports/aspects/yearly

Panoramica (solo generale):

• POST /api/v1/horoscope/reports/aspects/daily/overview
• POST /api/v1/horoscope/reports/aspects/weekly/overview
• POST /api/v1/horoscope/reports/aspects/monthly/overview
• POST /api/v1/horoscope/reports/aspects/yearly/overview

aspects/* supporta:

• modalità pubblica
• modalità personalizzata
• Override deterministico opzionale aspect
• lo stesso modello di sezione utilizzato nelle rotte oroscopiche aggiornate

D) Suite di Report sui Transiti (Superficie Periodizzata)¶

Sezioni (non generali):

• POST /api/v1/horoscope/reports/transits/daily
• POST /api/v1/horoscope/reports/transits/weekly
• POST /api/v1/horoscope/reports/transits/monthly
• POST /api/v1/horoscope/reports/transits/yearly

Panoramica (solo generale):

• POST /api/v1/horoscope/reports/transits/daily/overview
• POST /api/v1/horoscope/reports/transits/weekly/overview
• POST /api/v1/horoscope/reports/transits/monthly/overview
• POST /api/v1/horoscope/reports/transits/yearly/overview

transits/* supporta:

• modalità pubblica
• modalità personalizzata
• Override deterministico opzionale transit
• lo stesso modello di sezione utilizzato nelle rotte oroscopiche aggiornate

E) Suite di Report sulle Case (Solo Personalizzate, Superficie Periodizzata)¶

Report sulle case (sezioni non generali):

• POST /api/v1/horoscope/reports/house/daily
• POST /api/v1/horoscope/reports/house/weekly
• POST /api/v1/horoscope/reports/house/monthly
• POST /api/v1/horoscope/reports/house/yearly

Panoramiche sulle case (solo generale):

• POST /api/v1/horoscope/reports/house/daily/overview
• POST /api/v1/horoscope/reports/house/weekly/overview
• POST /api/v1/horoscope/reports/house/monthly/overview
• POST /api/v1/horoscope/reports/house/yearly/overview

Report pianeta-casa (sezioni non generali):

• POST /api/v1/horoscope/reports/planet/house/daily
• POST /api/v1/horoscope/reports/planet/house/weekly
• POST /api/v1/horoscope/reports/planet/house/monthly

• POST /api/v1/horoscope/reports/planet/house/yearlyPanoramiche delle case planetarie (solo generali):

• POST /api/v1/horoscope/reports/planet/house/daily/overview

• POST /api/v1/horoscope/reports/planet/house/weekly/overview
• POST /api/v1/horoscope/reports/planet/house/monthly/overview
• POST /api/v1/horoscope/reports/planet/house/yearly/overview

Entrambe le famiglie di percorsi sono esclusivamente personalizzate e sono supportate da endpoint del motore, come:

• /house-horoscope
• /planet-house-horoscope

F) Canonicalizzazione dello Spazio dei Nomi¶

I percorsi live-report ora utilizzano lo spazio dei nomi /api/v1/horoscope/reports/* in tutte le superfici oroscopiche aggiornate, supportate dal motore.

I percorsi non di report esistenti rimangono registrati come alias di compatibilità nascosti.

G) Nuove Famiglie di Percorsi della Sezione Oroscopica Aggiunte nel Tempo¶

Comunicazione¶

• POST /api/v1/horoscope/reports/communication/daily/today
• POST /api/v1/horoscope/reports/communication/daily/tomorrow
• POST /api/v1/horoscope/reports/communication/daily/yesterday
• POST /api/v1/horoscope/reports/communication/weekly
• POST /api/v1/horoscope/reports/communication/monthly
• POST /api/v1/horoscope/reports/communication/yearly

Amicizia¶

• POST /api/v1/horoscope/reports/friendship/daily/today
• POST /api/v1/horoscope/reports/friendship/daily/tomorrow
• POST /api/v1/horoscope/reports/friendship/daily/yesterday
• POST /api/v1/horoscope/reports/friendship/weekly
• POST /api/v1/horoscope/reports/friendship/monthly
• POST /api/v1/horoscope/reports/friendship/yearly

Stile di Vita¶

• POST /api/v1/horoscope/reports/lifestyle/daily/today
• POST /api/v1/horoscope/reports/lifestyle/daily/tomorrow
• POST /api/v1/horoscope/reports/lifestyle/daily/yesterday
• POST /api/v1/horoscope/reports/lifestyle/weekly
• POST /api/v1/horoscope/reports/lifestyle/monthly
• POST /api/v1/horoscope/reports/lifestyle/yearly

Superfici di Divisione Amorosa (Singoli/Coppie)¶

• POST /api/v1/horoscope/reports/love_singles/daily/today
• POST /api/v1/horoscope/reports/love_singles/daily/tomorrow
• POST /api/v1/horoscope/reports/love_singles/daily/yesterday
• POST /api/v1/horoscope/reports/love_singles/weekly
• POST /api/v1/horoscope/reports/love_singles/monthly
• POST /api/v1/horoscope/reports/love_couples/daily/today
• POST /api/v1/horoscope/reports/love_couples/daily/tomorrow
• POST /api/v1/horoscope/reports/love_couples/daily/yesterday
• POST /api/v1/horoscope/reports/love_couples/weekly
• POST /api/v1/horoscope/reports/love_couples/monthly

Aggiunte alla Sezione Annuale¶

• POST /api/v1/horoscope/reports/health/yearly
• POST /api/v1/horoscope/reports/money/yearly

H) Superficie dei Pianeti Informativi Rinominata¶

• GET /api/v1/horoscope/planets-info
• POST /api/v1/horoscope/planets-info

Questo sostituisce la precedente denominazione /horoscope/planets per il comportamento dello glossario.## Espansione dell'Orario Astrologico — Endpoint Aggiornati e Corretti

A) Migrazione del Motore e Aggiornamenti del Comportamento¶

Le seguenti famiglie di endpoint esistenti sono state aggiornate per utilizzare un motore interno:

Endpoint principali per i report¶

• POST /api/v1/horoscope/reports/today
• POST /api/v1/horoscope/reports/yesterday
• POST /api/v1/horoscope/reports/tomorrow
• POST /api/v1/horoscope/reports/weekly
• POST /api/v1/horoscope/reports/monthly
• POST /api/v1/horoscope/reports/yearly

Endpoint di categoria esistenti aggiornati dal comportamento precedente basato su horoscope.com¶

• carriera
• salute
• amore
• denaro

Famiglie esistenti e precedenti ristrutturate e aggiornate¶

• Endpoint legacy per l'amore divisi in love_singles e love_couples
• Comportamento combinato di yearly/career_money sostituito da endpoint dedicati per la carriera annuale e il denaro annuale
• Endpoint legacy per i report e le panoramiche planetarie spostati su endpoint periodici

B) Chiarimento dell'Endpoint della Descrizione del Segno Zodiacale¶

I seguenti endpoint rimangono descrittivi, non endpoint di report in tempo reale:

• /api/v1/horoscope/sign/personality
• /api/v1/horoscope/sign/communication
• /api/v1/horoscope/sign/friendship
• /api/v1/horoscope/sign/love
• /api/v1/horoscope/sign/lifestyle
• /api/v1/horoscope/sign/health
• /api/v1/horoscope/sign/career
• /api/v1/horoscope/sign/money
• /api/v1/horoscope/sign/parent_child
• /api/v1/horoscope/sign/spirituality
• /api/v1/horoscope/sign/shadow

C) Aggiornamento della Parità dell'Orario Astrologico per la Data di Nascita¶

POST /api/v1/horoscope/reports/birthday espone ora le chiavi di richiesta native del motore, mantenendo al contempo le chiavi di compatibilità.

Superficie aggiornata:

• POST /api/v1/horoscope/reports/birthday

Alias di compatibilità nascosti mantenuti:- /api/v1/horoscope/birthday - /api/v1/horoscope/sign/birthday

Chiavi di richiesta native del motore esposte:

• sign
• target_date
• birth
• sections
• zodiac_system
• ayanamsa
• house_system
• node_type
• tenant_id

Chiavi di compatibilità mantenute:

• dob
• timezone
• year
• birth_time
• birth_latitude
• birth_longitude
• birth_timezone

D) Aggiornamento della Parità del Tema Natale¶

Queste superfici esistevano prima della versione 1.0.0 e ora sono aggiornate per una piena parità con il motore:

• POST /api/v1/birth-chart
• POST /api/v1/birth-chart/svg

I miglioramenti includono:

• Supporto completo per l'opzione di richiesta da gateway a motore
• Parità del campo "wheel configuration"
• Controlli più rigorosi sulla forma della risposta

E) Normalizzazione del Contratto di Risposta¶

Gli endpoint aggiornati, basati sul motore Horoscope, restituiscono:

• Payload di risposta nativo del motore
• _enterprise
• _api_metadata_

F) Gestione di Fuso Orario e Data Relativa¶

Gli endpoint giornalieri che utilizzano today, yesterday e tomorrow ora applicano la risoluzione della data di destinazione consapevole del fuso orario tramite l'input IANA per il fuso orario.

G) Chiarimento del Supporto alla Personalizzazione¶

Quando supportato, i report personalizzati vengono attivati fornendo campi "birth-vector" come:

• birth_time
• birth_latitude
• birth_longitude
• birth_timezone

Se omessi, i percorsi rimangono utilizzabili in modalità basata sul segno.## Espansione dell'API di Astrologia – Endpoint Deprecati, Nascosti e Rimosse| Endpoint | Stato in v1.0.0 | Sostituzione | Note | |---|---|---|---| | Percorso per il report aggregato planetario legacy | Rimosso | Percorsi periodali inferiori a /reports/planetary/ con percorsi specifici per periodo e i corrispondenti percorsi /overview | L'endpoint di aggregazione è stato rimosso dopo il completamento della parità periodale. | | POST /api/v1/horoscope/planetary/overview | Obsoleto (nascosto da OpenAPI) | POST /api/v1/horoscope/reports/planetary/daily/overview, POST /api/v1/horoscope/reports/planetary/weekly/overview, POST /api/v1/horoscope/reports/planetary/monthly/overview, POST /api/v1/horoscope/reports/planetary/yearly/overview | Sostituito dai percorsi di panoramica specifici per periodo. | | POST /api/v1/horoscope/planetary/daily/sections | Alias nascosto | POST /api/v1/horoscope/reports/planetary/daily | Alias interno per la compatibilità. | | POST /api/v1/horoscope/love_single/monthly | Alias obsoleto (nascosto) | POST /api/v1/horoscope/reports/love_singles/monthly | Mantenuto per la compatibilità. | | POST /api/v1/horoscope/weekly/retail | Obsoleto (nascosto da OpenAPI/docs) | Nessuno | Il report orario di superficie retail è stato rimosso dalla documentazione pubblica. | | Percorso flessibile per il report aggregato dell'oroscopo legacy | Rimosso | Percorsi di report specifici per sezione e percorsi di panoramica periodale | L'endpoint di aggregazione è stato rimosso dopo la completa suddivisione dell'endpoint. | | POST /api/v1/horoscope/yearly/career_money | Rimosso | POST /api/v1/horoscope/reports/career/yearly e POST /api/v1/horoscope/reports/money/yearly | Suddivisione dell'endpoint in percorsi dedicati. | | POST /api/v1/horoscope/love/{today,tomorrow,yesterday} | Rimossa registrazione attiva | POST /api/v1/horoscope/reports/love_singles/daily/{today,tomorrow,yesterday} o POST /api/v1/horoscope/reports/love_couples/daily/{today,tomorrow,yesterday} | "Daily love" è ora suddiviso in base al contesto relazionale. || GET /api/v1/horoscope/planets e POST /api/v1/horoscope/planets | Rinominato/rimosso | GET /api/v1/horoscope/planets-info e POST /api/v1/horoscope/planets-info | Rinomina dell'endpoint informativo per chiarezza. |

Espansione dell'Horoscopo — Modifiche incompatibili¶

• Rinominazione del percorso: /api/v1/horoscope/planets → /api/v1/horoscope/planets-info
• Lo spazio dei nomi canonico per i report di oroscopi basati sul motore è ora /api/v1/horoscope/reports/*
• I percorsi giornalieri combinati per l'amore sono stati sostituiti da percorsi espliciti per single e coppie
• Il percorso combinato annuale career_money è stato rimosso a favore di percorsi annuali dedicati
• Gli endpoint generici per i report planetari e le panoramiche sono stati deprecati a favore di percorsi strutturati per periodi
• I percorsi basati sul motore aggiornati standardizzati attorno ai corpi delle richieste POST

Espansione dell'Horoscopo — Note sulla compatibilità¶

• I percorsi legacy /api/v1/horoscope/report/* rimangono disponibili come alias nascoste e backward-compatibili
• La documentazione pubblica e l'OpenAPI presentano ora solo lo spazio dei nomi canonico /api/v1/horoscope/reports/*
• Le nuove integrazioni dovrebbero adottare immediatamente i percorsi /reports/*

Espansione dell'Horoscopo — Note sulla migrazione¶

1) Mappa di migrazione del percorso endpoint- GET/POST /api/v1/horoscope/planets → GET/POST /api/v1/horoscope/planets-info¶

• POST /api/v1/horoscope/report/{surface} → POST /api/v1/horoscope/reports/{surface}
• POST /api/v1/horoscope/{surface} → POST /api/v1/horoscope/reports/{surface}
• POST /api/v1/horoscope/planetary/overview → POST /api/v1/horoscope/reports/planetary/{period}/overview
• Percorso di aggregazione planetaria legacy → POST /api/v1/horoscope/reports/planetary/{period} o equivalente di panoramica
• Percorso di aggregazione oroscopica flessibile legacy → percorsi specifici per sezione o percorsi di panoramica
• POST /api/v1/horoscope/yearly/career_money → dividere in percorsi annuali per carriera e annuali per denaro
• Percorsi giornalieri di amore legacy → dividere in love_singles o love_couples

2) Migrazione del Payload della Richiesta¶

Per i percorsi supportati dal motore, utilizzare corpi POST strutturati con campi come:

• dob
• timezone
• Selettori di periodo come day, target_date o year
• Opzioni del motore facoltative:
• zodiac_system
• ayanamsa
• house_system
• node_type
• tenant_id
• Campi di personalizzazione facoltativi:
• birth_time
• birth_latitude
• birth_longitude
• birth_timezone

3) Regole di Migrazione del Percorso Planetario¶

• Utilizzare sections solo sui percorsi planetari non di panoramica.
• general è accessibile tramite percorsi dedicati /overview.

4) Migrazione del Parser di Risposta¶

I client devono analizzare:

• I campi del payload del report direttamente dal corpo della risposta.
• _enterprise
• _api_metadata_

5) Nota sul Comportamento di TraduzioneThe horoscope engine itself does not generate multilingual content directly, so report based endpoints currently support but en only.¶

Endpoint non di report continuano a supportare la traduzione multilingue completa tramite livelli di assistenza del gateway utilizzando lang, come ad esempio: - en - es - de - fr - pt

Espansione dell'Horoscope — Documentazione e Coerenza Qualità Completate¶

• Documentazione pubblica aggiornata per le nuove rotte di accesso all'API di oroscopi

---- Documentazione planetaria storica sostituita da documentazione planetaria specifica per periodo

---- Documentazione relativa alla carriera e al denaro divisa, con rimozione delle rotte combinate

---- Esempio JSON con struttura sincronizzata con le risposte dell'endpoint per la documentazione aggiornata¶

Espansione dell'Horoscope — Elenco di controllo per l'aggiornamento del client consigliato¶

• Aggiornare tutti i percorsi rinominati e obsoleti utilizzando la mappa di migrazione

--- FINE MARKDOWN ---- Passare qualsiasi consumatore legacy di richieste GET per i nuovi percorsi di report a richieste del corpo POST

--- FINE MARKDOWN ---- Aggiungere il fuso orario a tutti i flussi giornalieri per evitare lo sfasamento delle date relative

---- Aggiungere campi di personalizzazione dove è desiderato contenuti editoriali specifici per l'utente

---- Aggiornare i parser di risposta per mantenere _enterprise e _api_metadata_- Eseguire nuovamente i test di integrazione contro tutti gli endpoint degli oroscopi utilizzati in produzione

---¶

Riepilogo delle Note di Rilascio — Espansione dell'API per l'Oroscopo¶

L'API Numerology v1.0.0 completa un importante rilascio che garantisce la compatibilità con il motore, espande la copertura dei report in diverse sezioni e periodi, introduce una struttura di routing più pulita e definisce una superficie di produzione più chiara per le future iterazioni del motore interno per l'oroscopo.

Parte III — Linee Guida per l'Integrazione Multi-API¶

Note di Integrazione Unificate per i Client che Utilizzano l'API Numerology¶

I client che consumano sia gli endpoint Numerology che quelli Horoscope dovrebbero rivedere le seguenti informazioni insieme:

Autenticazione e Accesso¶

• Gli endpoint Numerology estesi sono supportati solo direttamente (senza supporto del gateway RapidAPI)
• Anche i percorsi dell'oroscopo basati sul motore sono supportati solo direttamente e continuano sotto il loro namespace API canonico con modelli di gateway aggiornati
• Mantenere il supporto per wrapper di metadati in stile enterprise

Modellazione delle Richieste¶

• Preferire corpi POST strutturati esplicitamente per tutti i nuovi endpoint aggiornati o ampliati
• Validare i formati di data, i selettori di periodo, le stringhe di fuso orario e gli oggetti nidificati lato client
• Ove disponibile, fornire vettori di personalizzazione per risultati più ricchi### Semantica di fuso orario e data
• Gli endpoint di Numerology dipendono da formati di data e mese corretti
• I percorsi giornalieri di Horoscope dipendono dalla corretta gestione del fuso orario per la risoluzione dei giorni relativi
• Si raccomanda vivamente l'utilizzo di stringhe IANA, ove supportato

Gestione delle lingue¶

• Gli endpoint estesi di Numerology hanno rendering multilingue verificato
• I percorsi di Horoscope supportati dal motore continuano a supportare solo en

Consigli per il rilascio in produzione¶

• aggiornare prima gli SDK e i validatori di richieste
• aggiornare poi i test di integrazione
• quindi promuovere le modifiche ai percorsi/percorsi ai client di produzione
• monitorare eventuali alias di compatibilità nascoste ancora in uso internamente, in modo da poterli eliminare in seguito con sicurezza

Parte IV — Riepilogo del rilascio finale¶

Cosa significa v1.0.0¶

v1.0.0 rappresenta il punto in cui entrambe le superfici raggiungono un livello di completezza e adeguatezza per l'ambiente di produzione:- Numerology API ora espone un catalogo molto più ricco e dettagliato, che copre aspetti come il tempismo, l'identità, la comprensione spirituale, il lavoro sui propri lati oscuri, le relazioni, la compatibilità e i calendari predittivi. - I report di oroscopo ora si basano su una fondazione molto più solida, con namespace di report canonici, una copertura più ampia delle sezioni, modelli di migrazione più chiari e una migliore coerenza tra le famiglie di report. - La documentazione, gli esempi, il comportamento di validazione e le linee guida per la compatibilità sono significativamente più mature rispetto allo stato pre-v1.0.0.

Questa release non è solo un aggiornamento della versione. È una release strutturale che migliora:

• la completezza della piattaforma
• la chiarezza delle rotte
• la prontezza alla migrazione del client
• la fiducia nella documentazione
• la coerenza nell'integrazione aziendale

Raccomandazioni operative¶

Per tutti gli integratori attivi, il percorso raccomandato è:

1. adottare immediatamente le rotte canoniche
2. aggiornare i modelli di richiesta per i payload POST-first, ove applicabile
3. preservare l'analisi del wrapper dei metadati
4. validare i formati di fuso orario/data lato client
5. spostare i consumatori avanzati di Numerology all'accesso diretto alla piattaforma
6. eseguire nuovamente un test completo di integrazione prima del rilascio in produzione

Nota conclusivaThis unified changelog reflects the v1.0.0 release state for The Numerology API and consolidates the major rollout work completed for the 2026-04-12 release window.¶