Immagine SVG del grafico natale¶

L'endpoint Immagine SVG del grafico natale restituisce l'output SVG della ruota natale dal motore interno, con supporto completo per la visualizzazione completa/rendering.

Supporto linguistico: Tutte le 26 lingue supportate. Le risposte non in inglese vengono tradotte al volo dall'helper del traduttore (LibreTranslate come predefinito; DeepL BYOK, MyMemory o Google selezionabili per richiesta).

Endpoint¶

Corpo della richiesta¶

Campi di primo livello| Nome | Obbligatorio | Tipo | Esempio | Descrizione |¶

|---|---|---|---|---| | sign | No | string | CANCER | Segno zodiacale. Valori consentiti: ARIES, TAURUS, GEMINI, CANCER, LEO, VIRGO, LIBRA, SCORPIO, SAGITTARIUS, CAPRICORN, AQUARIUS, PISCES. | | target_date | No | string | 2026-04-08 | Data di fallback pubblica/segno (YYYY-MM-DD). | | birth | No | oggetto | {...} | Blocco di nascita nativo del motore (vedi tabella nidificata). | | sections | No | array[string] | ["general"] | Sezioni richieste. | | zodiac_system | No | string | tropical | Valori consentiti: sidereal, tropical. | | ayanamsa | No | string | lahiri | Valori consentiti: lahiri, fagan_bradley, krishnamurti, raman, yukteswar. | | house_system | No | string | placidus | Valori consentiti: placidus, whole_sign, equal, koch. | | node_type | No | string | true | Valori consentiti: true, mean. | | tenant_id | No | string | docs-smoke | Override opzionale dello spazio dei nomi tenant/cache. | | user_name | No | string | Docs Smoke User | Etichetta utente per il rendering del grafico. | | output_mode | No | string | wheel_only | Valori consentiti: full, report_only, wheel_only. || include_wheel_svg | No | booleano | true | Includere l'artefatto SVG della ruota nel percorso di rendering. | | split | No | booleano | false | false: Risposta SVG binaria. true: Raggruppamento SVG in formato JSON, se supportato. | | round_wheel_only | No | booleano | true | Renderizzare solo la ruota circolare. | | transparent_background | No | booleano | true | Modalità sfondo trasparente. | | svg_compression | No | stringa | none | Valori consentiti: none, gzip. | | language | No | stringa | en | Chiave della lingua del motore (da 2 a 16 caratteri). | | locale | No | stringa | en-US | Chiave di localizzazione del motore (da 2 a 20 caratteri). | | wheel | No | oggetto | {...} | Opzioni per il rendering della ruota (vedi tabella nidificata). | | theme | No | stringa | classic | Chiave di compatibilità legacy, mappata a wheel.theme (classic->paper, light->day, dark->night, dark-high-contrast->obsidian). | | lang | No | stringa | en | Chiave di compatibilità legacy, mappata a language. | | name | No | stringa | User | Alias legacy per user_name. | | year | No | intero | 1992 | Anno di nascita appiattito (legacy), da utilizzare con month e day. | | month | No | intero | 7 | Mese di nascita appiattito (legacy). || day | No | integer | 16 | Data di nascita (formato legacy) | | hour | No | integer | 13 | Ora di nascita (formato legacy) | | minute | No | integer | 45 | Minuto di nascita (formato legacy) | | lat | No | number | 40.7128 | Latitudine (formato legacy) - Da abbinare a lng | | lng | No | number | -74.0060 | Longitudine (formato legacy) - Da abbinare a lat | | tz_str | No | string | America/New_York | Alias del fuso orario (formato legacy) | | city | No | string | New York | Campo di compatibilità (formato legacy) | | country | No | string | US | Campo di compatibilità (formato legacy) |

birth Campi dell'Oggetto| Nome | Obbligatorio | Tipo | Esempio | Descrizione |¶

|------|----------|------|---------|-------------| | birth.date | Sì (se fornito birth) | stringa | 1992-07-16 | Data di nascita (YYYY-MM-DD). | | birth.time | No | stringa | 13:45 | Ora di nascita (HH:MM, in ore), da 0 a 24. | | birth.coordinates | No | oggetto | { "latitude": 40.7128, "longitude": -74.006 } | Blocco di coordinate. | | birth.coordinates.latitude | No | numero | 40.7128 | Intervallo: da -90 a 90. | | birth.coordinates.longitude | No | numero | -74.0060 | Intervallo: da -180 a 180. | | birth.timezone | No | stringa | America/New_York | Fuso orario IANA. |

wheel Campi dell'oggetto| Nome | Obbligatorio | Tipo | Esempio | Descrizione |¶

|---|---|---|---|---| | wheel.preset_id | No | string | minimal_app | Validi: minimal_app, editorial_full, print_clean. | | wheel.preset_override_mode | No | string | merge | Validi: merge, preset_only. | | wheel.size | No | integer | 720 | Intervallo: da 720 a 2400. | | wheel.theme | No | string | custom | Validi: night, day, aurora, paper, obsidian, sunset, zenith, mono, custom. Usa custom insieme a wheel.theme_palette per il pieno controllo dei colori. | | wheel.panel_layout | No | string | bottom | Validi: right, bottom. | | wheel.accent_color | No | string | #3ddd77 | Colore esadecimale. | | wheel.background_gradient | No | array[string] | ["#0b1020", "#111b3b", "#1b2f6d"] | Gradiente a 3 colori opzionale. | | wheel.panel_opacity | No | number | 0.78 | Intervallo: da 0.2 a 1.0. | | wheel.theme_palette | No | oggetto | { "center_fill": "#0d1832", "panel_opacity": 0.78 } | Override opzionale della palette del tema personalizzato (vedi Temi personalizzati della ruota). Gli override parziali sono consentiti su qualsiasi tema; obbligatorio quando theme è custom. | | wheel.aspect_line_opacity | No | number | 0.58 | Intervallo: da 0.1 a 1.0. | | wheel.show_aspect_lines | No | boolean | true | Mostra le linee di aspetto. | | wheel.show_house_cusps | No | boolean | true | Mostra i marcatori delle cuspidi delle case. | | wheel.show_house_numbers | No | boolean | true | Mostra i numeri delle case. | | wheel.show_sign_symbols | No | boolean | true | Mostra i simboli dello zodiaco. | | wheel.show_sign_names | No | boolean | true | Mostra le etichette dello zodiaco. | | wheel.show_degree_ticks | No | booleano | true | Mostra tacche di graduazione. | | wheel.show_degree_labels | No | booleano | true | Mostra etichette dei gradi. | | wheel.degree_tick_interval | No | intero | 5 | Intervallo: da 1 a 30. | | wheel.show_planet_symbols | No | booleano | true | Mostra simboli dei pianeti. | | wheel.planet_symbol_size | No | numero | 15.0 | Intervallo: da 10.0 a 30.0. | | wheel.planet_marker_size | No | numero | 6.3 | Intervallo: da 3.0 a 12.0. | | wheel.show_planet_table | No | booleano | true | Mostra pannello della tabella dei pianeti. | | wheel.show_aspect_table | No | booleano | true | Mostra pannello della tabella degli aspetti. | | wheel.show_sign_legend | No | booleano | true | Mostra legenda dei segni. | | wheel.show_element_balance | No | booleano | true | Mostra pannello dell'equilibrio degli elementi. | | wheel.show_metadata | No | booleano | true | Mostra pannello dei metadati. | | wheel.show_title | No | booleano | true | Mostra titolo/sottotitolo. | | wheel.show_angle_markers | No | booleano | true | Mostra marcatori ASC/MC. | | wheel.show_center_signature | No | booleano | true | Mostra testo della firma del centro. | | wheel.title | No | stringa | Docs SVG | Titolo opzionale per la ruota. | | wheel.subtitle | No | stringa | Expanded parity example | Sottotitolo opzionale per la ruota. | | wheel.custom_planet_colors | No | oggetto | { "Sun": "#ffbb33" } | Mappa da nome del pianeta a colore esadecimale. |Questo endpoint restituisce SVG (image/svg+xml) per impostazione predefinita. Può restituire parti di SVG in formato JSON separate quando split=true.

Temi personalizzati della ruota (theme: "custom" + theme_palette)¶

I colori e la trasparenza della ruota sono completamente personalizzabili: imposta wheel.theme su custom e passa un oggetto theme_palette. Vengono sovrascritte solo le chiavi che fornisci — tutto il resto ripiega sulla palette di base scura night.

{
  "wheel": {
    "theme": "custom",
    "accent_color": "#3ddd77",
    "theme_palette": {
      "bg_0": "#0b1730",
      "bg_1": "#101d38",
      "bg_2": "#0a1326",
      "panel_fill": "#0c1730",
      "panel_opacity": 0.78,
      "sign_line": "#2b3f63",
      "ring_inner": "#34486a",
      "center_fill": "#0d1832",
      "center_stroke": "#1e2f4a",
      "divider": "#2a3f64",
      "subtitle": "#8fa2c2",
      "text": "#dbe7f8",
      "soft_text": "#9fb0cd"
    }
  }
}

Chiavi di theme_palette¶

Regole¶

• Override parziali — vengono applicate solo le chiavi che fornisci; il resto ripiega sulla palette di base del tema (custom usa la base scura night).
• I valori dei colori devono essere hex di 7 caratteri (#rrggbb); panel_opacity deve essere un float in [0, 1]. Chiavi sconosciute o valori non validi → errore di validazione 422.
• theme_palette è obbligatorio quando theme è "custom".
• Sui temi denominati (ad es. paper) theme_palette agisce come override parziale.
• Cambiano solo gli aspetti visivi della ruota — i calcoli della carta, le posizioni e gli aspetti non vengono mai influenzati.

Esempio di tema personalizzato¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/birth-chart/svg" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "birth": {
    "date": "1992-07-16",
    "time": "13:45",
    "coordinates": { "latitude": 40.7128, "longitude": -74.006 },
    "timezone": "America/New_York"
  },
  "wheel": {
    "theme": "custom",
    "accent_color": "#3ddd77",
    "theme_palette": {
      "bg_0": "#0b1730",
      "bg_1": "#101d38",
      "bg_2": "#0a1326",
      "panel_fill": "#0c1730",
      "panel_opacity": 0.78,
      "sign_line": "#2b3f63",
      "ring_inner": "#34486a",
      "center_fill": "#0d1832",
      "center_stroke": "#1e2f4a",
      "divider": "#2a3f64",
      "subtitle": "#8fa2c2",
      "text": "#dbe7f8",
      "soft_text": "#9fb0cd"
    }
  }
}'

Precedenza di theme legacy su questo endpoint¶

Il campo theme di primo livello legacy è ancora supportato:

1. Un theme di primo livello esplicito (ad es. "theme": "dark") ha la precedenza.
2. Altrimenti viene usato wheel.theme (ad es. "custom" + theme_palette).
3. Altrimenti si applica il default storico classic (→ paper).

Alias legacy: classic → paper, light → day, dark → night, dark-high-contrast → obsidian.

Esempio in Modalità Personalizzata (Consigliato)¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/birth-chart/svg" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "sign": "CANCER",
  "target_date": "2026-04-08",
  "zodiac_system": "tropical",
  "ayanamsa": "lahiri",
  "house_system": "placidus",
  "node_type": "true",
  "tenant_id": "docs-smoke",
  "user_name": "Docs Smoke User",
  "output_mode": "wheel_only",
  "include_wheel_svg": true,
  "split": false,
  "round_wheel_only": true,
  "transparent_background": true,
  "svg_compression": "none",
  "language": "en",
  "locale": "en-US",
  "birth": {
    "date": "1992-07-16",
    "time": "13:45",
    "coordinates": { "latitude": 40.7128, "longitude": -74.006 },
    "timezone": "America/New_York"
  },
  "wheel": {
    "preset_id": "minimal_app",
    "theme": "paper",
    "panel_layout": "bottom",
    "size": 720
  }
}'

Esempio in Modalità Pubblica (Generale, basata sul segno zodiacale)¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/birth-chart/svg" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "sign": "CANCER",
  "target_date": "2026-04-08",
  "output_mode": "wheel_only",
  "split": false,
  "round_wheel_only": true,
  "language": "en",
  "locale": "en-US",
  "wheel": { "preset_id": "minimal_app", "theme": "paper", "size": 720 }
}'

Esempio di Risposta¶

Esempi di SVG Renderizzati¶

Impostazione Predefinita (Merge Override) Con Linee di Proporzione Attivate¶

Esempio Tropical Zenith¶

Esempio Sidereal Obsidian¶