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: Acest endpoint, bazat pe motorul /api/v1/birth-chart/svg, suportă în prezent doar limba engleză (lang=en).

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

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¶

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

Exemple de SVG Renderate¶

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

Exemplu Tropical Zenith¶

Exemplu Sidereal Obsidian¶