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: Questo endpoint /api/v1/birth-chart/svg, basato sul motore, supporta attualmente solo l'inglese (lang=en).

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 | paper | Validi: night, day, aurora, paper, obsidian, sunset, zenith, mono. | | 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.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.

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¶

{
  "content_type": "image/svg+xml",
  "content_length": 31774,
  "preview": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"538\" height=\"538\" viewBox=\"0 0 538 538\"><g transform=\"translate(-111.25 -13.97)\"><circle cx=\"380.00\" cy=\"282.72\" r=\"214.32\" fill=\"none\" stroke=\"#3ddd77\" stroke-width=\"3.1\" /><circle cx=\"380.00\" cy=\"282.72\" r=\"144.40\" fill=\"none\" stroke=\"#ad9478\" stroke-width=\"2.3\" /><circle cx=\"380.00\" cy=\"282.72\" r=\"90.97\" fill=\"#f0e7d8\" stroke=\"#c4ad92\" stroke-width=\"1.0\" opacity=\"0.95\" /><line x1=\"380.00\" y1=\"65.19\" x2=\"380.00\" y2=\"55.11\" stroke=\"#c7b399\" stroke-width=\"1.4\" opacity=\"0.86\" /><text x=\"380.00\" y=\"49.11\" text-anchor=\"middle\" dominant-baseline=\"middle\" font-size=\"10.0\" font-family=\"'Menlo','Consolas','SFMono-Regular','DejaVu Sans Mono','Liberation Mono',monospace\" fill=\"#745f47\">0\u00b0</text><line x1=\"398.77\" y1=\"68.15\" x2=\"399.33\" y2=\"61.74\" stroke"
}

Esempi di SVG Renderizzati¶

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

Esempio Tropical Zenith¶

Esempio Sidereal Obsidian¶