Imagine SVG a Hărții Nașterii¶

Endpoint-ul Imagine SVG a Hărției Nașterii returnează ieșirea SVG a cercului natal generat de motorul intern, cu suport complet pentru afișarea întregului cerc/render.

Suport lingvistic: Sunt acceptate toate cele 26 de limbi. Răspunsurile care nu sunt în engleză sunt traduse din mers de asistentul de traducere (implicit LibreTranslate; DeepL BYOK, MyMemory sau Google selectabile per cerere).

Endpoint¶

Corpul Cererii¶

Câmpuri de Nivel Superior| Nume | Obligatoriu | Tip | Exemplu | Descriere |¶

|---|---|---|---|---| | sign | Nu | string | CANCER | Semn zodiacal. Valori permise: ARIES, TAURUS, GEMINI, CANCER, LEO, VIRGO, LIBRA, SCORPIO, SAGITTARIUS, CAPRICORN, AQUARIUS, PISCES. | | target_date | Nu | string | 2026-04-08 | Data de rezervă publică/semn (YYYY-MM-DD). | | birth | Nu | obiect | {...} | Bloc de naștere nativ al motorului (vezi tabelul imbricat). | | sections | Nu | array[string] | ["general"] | Secțiunile solicitate. | | zodiac_system | Nu | string | tropical | Valori permise: sidereal, tropical. | | ayanamsa | Nu | string | lahiri | Valori permise: lahiri, fagan_bradley, krishnamurti, raman, yukteswar. | | house_system | Nu | string | placidus | Valori permise: placidus, whole_sign, equal, koch. | | node_type | Nu | string | true | Valori permise: true, mean. | | tenant_id | Nu | string | docs-smoke | Override opțional al spațiului de nume pentru tenant/cache. | | user_name | Nu | string | Docs Smoke User | Etichetă utilizator pentru afișarea graficului. | | output_mode | Nu | string | wheel_only | Valori permise: full, report_only, wheel_only. || include_wheel_svg | Nu | boolean | true | Includeți fișierul SVG al roții în calea de randare. | | split | Nu | boolean | false | false: Răspuns binar SVG. true: Grupați fișierul JSON SVG într-un format separat, dacă este suportat. | | round_wheel_only | Nu | boolean | true | Randare doar a roții circulare. | | transparent_background | Nu | boolean | true | Mod de fundal transparent. | | svg_compression | Nu | string | none | Permis: none, gzip. | | language | Nu | string | en | Cheie pentru limba motorului (2-16 caractere). | | locale | Nu | string | en-US | Cheie pentru localizarea motorului (2-20 caractere). | | wheel | Nu | obiect | {...} | Opțiuni de randare a roții (vezi tabelul imbricat). | | theme | Nu | string | classic | Cheie de compatibilitate veche, mapată la wheel.theme (classic->paper, light->day, dark->night, dark-high-contrast->obsidian). | | lang | Nu | string | en | Cheie de compatibilitate veche, mapată la language. | | name | Nu | string | User | Alias vechi pentru user_name. | | year | Nu | integer | 1992 | Anul de naștere "flattened" vechi (utilizat cu month și day). | | month | Nu | integer | 7 | Luna de naștere "flattened" vechi. || day | Nu | integer | 16 | Ziua nașterii, formatată în mod vechi. | | hour | Nu | integer | 13 | Ora nașterii, formatată în mod vechi. | | minute | Nu | integer | 45 | Minutul nașterii, formatat în mod vechi. | | lat | Nu | number | 40.7128 | Latitudine, formatată în mod vechi (trebuie să fie asociată cu lng). | | lng | Nu | number | -74.0060 | Longitudine, formatată în mod vechi (trebuie să fie asociată cu lat). | | tz_str | Nu | string | America/New_York | Alias pentru fusul orar, formatat în mod vechi. | | city | Nu | string | New York | Câmp de compatibilitate, formatat în mod vechi. | | country | Nu | string | US | Câmp de compatibilitate, formatat în mod vechi. |

birth Câmpuri ale obiectului| Nume | Obligatoriu | Tip | Exemplu | Descriere |¶

|------|----------|------|---------|-------------| | birth.date | Da (dacă este furnizat birth) | Șir de caractere | 1992-07-16 | Data nașterii (YYYY-MM-DD). | | birth.time | Nu | Șir de caractere | 13:45 | Ora nașterii (HH:MM, format 24h). | | birth.coordinates | Nu | Obiect | { "latitude": 40.7128, "longitude": -74.006 } | Bloc de coordonate. | | birth.coordinates.latitude | Nu | Număr | 40.7128 | Interval: -90 până la 90. | | birth.coordinates.longitude | Nu | Număr | -74.0060 | Interval: -180 până la 180. | | birth.timezone | Nu | Șir de caractere | America/New_York | Fus orar IANA. |

wheel Câmpuri Obiect| Nume | Obligatoriu | Tip | Exemplu | Descriere |¶

|------|----------|------|---------|-------------| | wheel.preset_id | Nu | string | minimal_app | Valide: minimal_app, editorial_full, print_clean. | | wheel.preset_override_mode | Nu | string | merge | Valide: merge, preset_only. | | wheel.size | Nu | integer | 720 | Interval: de la 720 la 2400. | | wheel.theme | Nu | string | custom | Valide: night, day, aurora, paper, obsidian, sunset, zenith, mono, custom. Utilizați custom împreună cu wheel.theme_palette pentru control complet al culorilor. | | wheel.panel_layout | Nu | string | bottom | Valide: right, bottom. | | wheel.accent_color | Nu | string | #3ddd77 | Culoare hexadecimală. | | wheel.background_gradient | Nu | array[string] | ["#0b1020", "#111b3b", "#1b2f6d"] | Override opțional de gradient cu 3 culori. | | wheel.panel_opacity | Nu | number | 0.78 | Interval: de la 0.2 la 1.0. | | wheel.theme_palette | Nu | object | { "center_fill": "#0d1832", "panel_opacity": 0.78 } | Override opțional al paletei de temă personalizată (a se vedea Teme personalizate pentru roată). Suprascrierile parțiale sunt permise pentru orice temă; obligatoriu când theme este custom. | | wheel.aspect_line_opacity | Nu | number | 0.58 | Interval: de la 0.1 la 1.0. | | wheel.show_aspect_lines | Nu | boolean | true | Afișează liniile de aspect. | | wheel.show_house_cusps | Nu | boolean | true | Afișează marcajele de la colțurile caselor. | | wheel.show_house_numbers | Nu | boolean | true | Afișează numerele caselor. | | wheel.show_sign_symbols | Nu | boolean | true | Afișează simbolurile zodiacale. | | wheel.show_sign_names | Nu | boolean | true | Afișează etichetele zodiacale. | | wheel.show_degree_ticks | Nu | boolean | true | Afișează marcajele de grad. | | wheel.show_degree_labels | Nu | boolean | true | Afișează etichetele de grad. | | wheel.degree_tick_interval | Nu | integer | 5 | Interval: 1 până la 30. | | wheel.show_planet_symbols | Nu | boolean | true | Afișează simbolurile planetelor. | | wheel.planet_symbol_size | Nu | number | 15.0 | Interval: 10.0 până la 30.0. | | wheel.planet_marker_size | Nu | number | 6.3 | Interval: 3.0 până la 12.0. | | wheel.show_planet_table | Nu | boolean | true | Afișează panoul tabel cu planete. | | wheel.show_aspect_table | Nu | boolean | true | Afișează panoul tabel cu aspecte. | | wheel.show_sign_legend | Nu | boolean | true | Afișează legenda semnului. | | wheel.show_element_balance | Nu | boolean | true | Afișează panoul de echilibru al elementelor. | | wheel.show_metadata | Nu | boolean | true | Afișează panoul de metadate. | | wheel.show_title | Nu | boolean | true | Afișează titlul/subtitlul. | | wheel.show_angle_markers | Nu | boolean | true | Afișează marcajele ASC/MC. | | wheel.show_center_signature | Nu | boolean | true | Afișează textul semnăturii centrului. | | wheel.title | Nu | string | Docs SVG | Titlul opțional al cercului. | | wheel.subtitle | Nu | string | Expanded parity example | Subtitlul opțional al cercului. | | wheel.custom_planet_colors | Nu | object | { "Sun": "#ffbb33" } | Harta de la numele planetei la culoare hex. |Această endpoint returnează SVG (image/svg+xml) ca valoare implicită. Poate returna părți JSON SVG separate atunci când este specificat split=true.

Teme Personalizate pentru Roată (theme: "custom" + theme_palette)¶

Culorile și transparența roții sunt complet personalizabile: setați wheel.theme pe custom și transmiteți un obiect theme_palette. Numai cheile pe care le furnizați sunt suprascrise — tot restul revine la paleta de bază întunecată 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"
    }
  }
}

Chei theme_palette¶

Reguli¶

• Suprascrieri parțiale — se aplică numai cheile pe care le furnizați; restul revine la paleta de bază a temei (custom folosește baza întunecată night).
• Valorile culorilor trebuie să fie hex de 7 caractere (#rrggbb); panel_opacity trebuie să fie un număr float în [0, 1]. Chei necunoscute sau valori invalide → eroare de validare 422.
• theme_palette este obligatoriu când theme este "custom".
• Pentru temele numite (de ex. paper), theme_palette acționează ca suprascriere parțială.
• Se schimbă doar vizualul roții — calculele hărții, pozițiile și aspectele nu sunt niciodată afectate.

Exemplu de temă personalizată¶

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"
    }
  }
}'

Prioritatea theme legacy pe acest endpoint¶

Câmpul legacy de nivel superior theme este încă suportat:

1. Un theme explicit de nivel superior (de ex. "theme": "dark") are prioritate.
2. În caz contrar, se folosește wheel.theme (de ex. "custom" + theme_palette).
3. În caz contrar, se aplică valoarea istorică implicită classic (→ paper).

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

Exemplu în Mod Personalizat (Recomandat)¶

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
  }
}'

Exemplu în Mod Public (General, Bazat pe Semn)¶

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 }
}'

Exemplu de Răspuns¶

Exemple de SVG Renderate¶

Preset de Printare (Merge Override) Cu Linii de Aspect Activate¶

Exemplu Tropical Zenith¶

Exemplu Sidereal Obsidian¶