The Numerology API v1.0.2¶

L'API Numerologica è una piattaforma di livello produttivo per creare prodotti di numerologia e astrologia con output deterministici, contratti JSON strutturati e un'ampia copertura di endpoint.

• Oltre 220 endpoint documentati tra numerologia, oroscopo, astrologia, compatibilità, viaggi, istruzione, eredità familiare e strumenti divinatori
• Versione corrente v1.0.2 con 10 nuove famiglie di endpoint estesi e copertura completa in 26 lingue
• Percorso pubblico RapidAPI per prototipazione rapida e onboarding
• Percorso API diretta + dashboard per integrazione avanzata e enterprise
• Documentazione pronta per gli sviluppatori con esempi di richieste, contratti parametri e pattern di risposta
• Rilasciata con v1.0.2 con 10 nuove famiglie di endpoint API diretta per traguardi relazionali, trasferimenti, veicoli, idoneità numeri telefonici, firme, animali domestici, progetti creativi, eredità familiare, percorsi formativi e allineamento destinazioni di viaggio
• 26 lingue di risposta supportate: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh
• Supporto numerologico multi-sistema tramite num_sys: pythagorean, chaldean e vedic

Novità di v1.0.2¶

v1.0.2 è un rilascio produttivo aggiuntivo per l'API Numerologica. Si basa sul traguardo v1.0.1 multi-sistema e 8 lingue, aggiungendo 10 nuove famiglie di endpoint estesi ed espandendo la copertura delle risposte a 26 lingue.

Questo rilascio si concentra su quattro obiettivi principali:

1. Nuova copertura endpoint estesi
2. Aggiunge 10 nuove famiglie di endpoint.
3. Ogni nuovo endpoint supporta sia GET che POST.
4. Tutti i nuovi endpoint utilizzano route pubbliche pulite sotto /api/v1/*.
5. Le nuove famiglie includono traguardi relazionali, trasferimenti, identità veicoli, idoneità numeri telefonici, firme, animali domestici, progetti creativi, eredità familiare, percorsi formativi e allineamento destinazioni di viaggio.

1. Continuità del supporto multi-sistema numerologico
2. I nuovi endpoint basati su nome/titolo/testo supportano num_sys opzionale.
3. Sistemi supportati:
   • pythagorean
   • chaldean
   • vedic

4. pythagorean rimane il predefinito per preservare il comportamento esistente.

5. Copertura linguistica ampliata

6. v1.0.1 rimane il traguardo rilasciato con 8 lingue:
   • en
   • es
   • de
   • fr
   • pt
   • ar
   • hi
   • ja
7. v1.0.2 aggiunge 18 lingue aggiuntive:
   • ru
   • tr
   • it
   • pl
   • nl
   • id
   • ko
   • th
   • ro
   • ur
   • gu
   • bn
   • vi
   • ta
   • te
   • mr
   • pa
   • zh

8. Le nuove famiglie di endpoint includono file JSON di significato localizzati in tutte le 26 directory linguistiche supportate.

9. Documentazione e prontezza del rilascio

10. Aggiunge documentazione di integrazione per tutte le 10 nuove famiglie di endpoint.
11. Aggiunge un changelog per v1.0.2.
12. Aggiorna l'indice degli Endpoint Estesi e i collegamenti al rilascio di riferimento dell'API.
13. Espone i nuovi endpoint nella documentazione interna della dashboard e nella scoperta tramite comandi.
14. Verifica la visibilità delle route, la copertura JSON, la struttura dei significati localizzati e la stabilità della suite di test con Python 3.11.

→ Leggi il Changelog Completo v1.0.2

Novità di v1.0.1¶

v1.0.1 è un rilascio produttivo aggiuntivo per l'API Numerologica. Si basa sul rollout esteso v1.0.0 aggiungendo letture più approfondite su nome, tempistica, business, decisioni, famiglia, team, denaro e archetipi.

Questo rilascio si concentra su quattro obiettivi principali:

1. Copertura endpoint più ampia
2. Aggiunge 10 nuove famiglie di endpoint.
3. Ogni nuovo endpoint supporta sia GET che POST.

4. Tutti i nuovi endpoint utilizzano route pubbliche pulite sotto /api/v1/*.

5. Numerologia multi-sistema

6. I nuovi endpoint basati su nome supportano num_sys opzionale.
7. Sistemi supportati:
   • pythagorean
   • chaldean
   • vedic

8. pythagorean rimane il predefinito per preservare il comportamento esistente.

9. Copertura linguistica ampliata

10. Le lingue di risposta supportate ora includono:
    • en
    • es
    • de
    • fr
    • pt
    • ar
    • hi
    • ja

11. Le 10 nuove famiglie di endpoint includono file JSON di significato localizzati per tutte le 8 lingue supportate.

12. Documentazione e prontezza del rilascio

13. Aggiunge documentazione di integrazione per tutte le 10 nuove famiglie di endpoint.
14. Aggiorna l'indice degli Endpoint Estesi.
15. Documenta il comportamento di GET, POST, lang e num_sys.
16. Verifica la visibilità delle route, la copertura JSON e la stabilità della suite di test con Python 3.11.

→ Leggi il Changelog Completo v1.0.1

Novità di v1.0.0¶

Questo rilascio combina due grandi filoni in un'unica versione di piattaforma:

1. Rollout esteso della Numerologia
2. Aggiunte 23 nuove famiglie di endpoint e 41 nuove operazioni GET/POST.
3. Aggiunte nuove categorie: Identità & Nome, Spirituale & Ombra e Relazione.
4. Ampliata la copertura temporale con route per settimana personale e giorno/settimana/mese/anno universale.

5. Validata la copertura multilingue di base (en, es, de, fr, pt) al 100% nel QA di rilascio.

6. Migrazione ed espansione del motore dell'oroscopo

7. Aggiunti oltre 53 nuovi endpoint con instradamento standardizzato dei report canonici sotto /api/v1/horoscope/reports/*.
8. Ampliate le famiglie di report giornalieri/settimanali/mensili/annuali e suite specializzate (planetari, aspetti, transiti, case, pianeta-casa).
9. Aggiornata la coerenza richiesta/risposta e la parità delle route per integrazioni di produzione.

→ Leggi il Changelog Completo v1.0.0 → Leggi l'Architettura del Motore dell'Oroscopo

Percorsi di Accesso¶

Mappa di Riferimento dell'API¶

• Panoramica Riferimento API
• Endpoint Principali
• Cicli e Transiti
• Identità & Nome
• Spirituale & Ombra
• Relazione
• Endpoint Ponte
• Endpoint Karmici
• Endpoint dell'Oroscopo
• Altri Endpoint (Tarocchi / Gematria)

Motore dell'Oroscopo (Modello di Produzione)¶

Lo stack dell'oroscopo è deterministico e basato su Swiss Ephemeris, progettato per un comportamento produttivo reale (output stabili, QA riproducibile e progettazione di route cache-friendly).

• Stack fattoriali deterministici per periodo (giornaliero, settimanale, mensile, annuale)
• Modalità pubblica (basata su segno) e modalità personalizzata (con dati di nascita)
• Suite di report oltre l'oroscopo generale: planetari, aspetti, transiti, case, pianeta-casa
• Wrapper enterprise nelle risposte (_enterprise, _api_metadata_) per metadati operativi

→ Approfondimento Motore → Panoramica Report dell'Oroscopo

Avvio Rapido¶

API Diretta (consigliata per copertura avanzata)¶

curl "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

Endpoint esteso API Diretta v1.0.2¶

curl "https://api.numerologyapi.com/api/v1/relationship-milestone-numerology?person_a_name=Amina%20Bello&person_a_dob=1992-04-18&person_b_name=Jonas%20Meyer&person_b_dob=1990-11-06&milestone_date=2027-06-12&milestone_type=wedding&num_sys=chaldean&lang=fr" \
  -H "X-API-Key: YOUR_API_KEY"

RapidAPI (route pubblica)¶

curl "https://the-numerology-api.p.rapidapi.com/life_path?birth_year=1990&birth_month=5&birth_day=15" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -H "x-rapidapi-host: the-numerology-api.p.rapidapi.com"

Struttura della Risposta (esempio)¶

{
  "life_path_number": 3,
  "summary": {
    "title": "Life Path 3",
    "overview": "Creative, expressive, and socially magnetic energy pattern."
  },
  "_enterprise": {
    "client": "The Numerology API"
  },
  "_api_metadata_": {
    "api_version": "1.0.2",
    "endpoint_name": "life_path",
    "documentation_url": "https://docs.numerologyapi.com/"
  }
}

Note di Migrazione per Integrazioni Esistenti¶

• Instradare le categorie v1.0.2 solo API diretta a https://api.numerologyapi.com.
• Preferire POST per contratti di richiesta più ricchi/annidati dove disponibile.
• Usare lang sulle route API diretta supportate per significati JSON localizzati nel set di 26 lingue.
• Usare num_sys sulle route numerologiche basate su nome/titolo/testo quando servono calcoli pythagorean, chaldean o vedic.
• Mantenere gli input di data/mese normalizzati (YYYY-MM-DD, YYYY-MM).
• Analizzare _enterprise e _api_metadata_ coerentemente nei propri modelli client.
• Per prodotti di oroscopo, passare agli endpoint /api/v1/horoscope/reports/* canonici.

Integrazione Plugin WordPress¶

Serve un percorso senza codice per la pubblicazione sul sito? Usa il plugin ufficiale Dakidarts Numerology Core per incorporare moduli, letture e report direttamente nelle pagine WordPress.

• Documentazione Plugin
• Installa da WordPress.org

Prossimi Passi¶

• Per Iniziare
• Prezzi
• Esempi
• Changelog
• Riferimento API