The Numerology API v1.0.3¶

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.3 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.3 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.3¶

La v1.0.3 aggiunge intelligenza zodiacale, personalizzazione completa della ruota SVG del tema natale, traduzione su richiesta e Numora Studio v0.1.0-beta.

• Endpoint per Sole, Luna, Ascendente, Modalità ed Elemento in /api/v1/horoscope/sign/.
• planet: general è l'opzione valida e predefinita per i report planetari.
• /api/v1/birth-chart/svg accetta un oggetto wheel completo per temi, palette, layout, visibilità, colori planetari, output separato e compressione.
• LibreTranslate, Google Translate e DeepL BYOK sono selezionabili per richiesta; il provider appare nei metadati.
• Numora Studio v0.1.0-beta è disponibile su macOS, Windows e Linux con chiavi tnsr_ separate.

→ Leggi il changelog v1.0.3

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, 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) 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"

{
  "numerology_system": "pythagorean",
  "life_path_number": 8,
  "summary": {
    "title": "Life Path 8: The Powerhouse & Master Manifestor",
    "overview": "Life Path 8 carries the vibration of material mastery, authority, karmic balance, and large-scale achievement. You are the empire builder, financial wizard, and natural leader, gifted with exceptional organizational power, resilience, and the ability to manifest wealth and influence. Your soul purpose is to master power and use it responsibly for the greater good.",
    "strengths": [
      "Extraordinary business acumen, strategic thinking, and leadership",
      "Natural authority, executive presence, and resilience",
      "Ability to manifest large-scale wealth and influence",
      "Strong sense of justice and karmic awareness"
    ],
    "challenges": [
      "Power struggles, control issues, and workaholism",
      "Karmic lessons around money, ethics, and authority",
      "Fear of vulnerability or appearing weak",
      "Tendency to equate worth with material success"
    ],
    "life_lesson": "The greatest evolution for Life Path 8 is learning that true power is service-oriented and ethical. When authority is used to uplift others rather than dominate, abundance becomes infinite and meaningful.",
    "ideal_career_paths": [
      "Corporate leadership, entrepreneurship, and C-suite positions",
      "Finance, investment banking, real estate, and wealth management",
      "Politics, large-scale organization, and executive consulting",
      "Business coaching, strategic planning, and high-level management"
    ],
    "spiritual_growth_tip": "Practice generous philanthropy and ethical leadership. When you circulate wealth and power with wisdom and compassion, your success becomes truly divine."
  },
  "detailed_meaning": "Number 8 symbolizes power, ambition, and material success. Life Path 8 individuals are natural leaders, focused on achievement and financial mastery. They excel in business and management roles where their executive abilities shine. Born with an understanding of material world dynamics, they possess remarkable organizational and strategic skills. Their confidence and authority inspire others while their determination overcomes seemingly insurmountable obstacles. In relationships, they seek equal partners who appreciate their drive and share their ambitious vision. Career fulfillment comes through entrepreneurship, finance, real estate, corporate leadership, or large-scale ventures. Challenges include workaholism, authoritarian tendencies, and prioritizing material over spiritual; balancing material pursuits with spiritual growth, compassion, and personal relationships ensures true fulfillment and lasting legacy.",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "9fe86d482c066afa",
    "quota": "unlimited",
    "usage_count": 1622,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.2",
    "endpoint_name": "life_path",
    "endpoint_description": "Calculates Life Path number from birth date.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-08-18T01:05:42.859507+01:00",
    "data_source": "Internal Engine",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "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"
    ],
    "notes": ""
  }
}

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