Zum Inhalt

Geburtstags-SVG-Bild

Der Endpunkt Geburtstags-SVG-Bild gibt die SVG-Ausgabe des natalen Kreises aus, die von dem internen Motor generiert wird, mit vollständiger Unterstützung für die Anzeige des Kreises/der Darstellung.

Sprache: Nur Englisch (derzeit)

Sprachunterstützung: Dieser von einem Motor bereitgestellte Endpunkt /api/v1/birth-chart/svg unterstützt derzeit nur Englisch (lang=en).

Endpunkt

Methode Pfad
POST https://api.numerologyapi.com/api/v1/birth-chart/svg

Anforderungs-Body

Oberhalb liegende Felder

Name Erforderlich Typ Beispiel Beschreibung
sign Nein string CANCER Sternzeichen. Erlaubte Werte: ARIES, TAURUS, GEMINI, CANCER, LEO, VIRGO, LIBRA, SCORPIO, SAGITTARIUS, CAPRICORN, AQUARIUS, PISCES.
target_date Nein string 2026-04-08 Datum für öffentliche/Fallback-Berechnung (YYYY-MM-DD).
birth Nein Objekt {...} Geburtselement, das vom Motor verwendet wird (siehe verschachtelte Tabelle).
sections Nein Array[string] ["general"] Angeforderte Abschnitte.
zodiac_system Nein string tropical Erlaubte Werte: sidereal, tropical.
ayanamsa Nein string lahiri Erlaubte Werte: lahiri, fagan_bradley, krishnamurti, raman, yukteswar.
house_system Nein string placidus Erlaubte Werte: placidus, whole_sign, equal, koch.
node_type Nein string true Erlaubte Werte: true, mean.
tenant_id Nein string docs-smoke Optionaler Override für Tenant/Cache-Namespace.
user_name Nein string Docs Smoke User Benutzerlabel für die Chart-Darstellung.
output_mode Nein string wheel_only Erlaubte Werte: full, report_only, wheel_only.
include_wheel_svg Nein boolean true SVG-Rad-Artefakt in den Render-Pfad einfügen.
split Nein boolean false false: Binäre SVG-Antwort. true: Aufteilung des JSON-SVG-Bundles, falls unterstützt.
round_wheel_only Nein boolean true Nur das kreisförmige Rad rendern.
transparent_background Nein boolean true Transparenter Hintergrundmodus.
svg_compression Nein string none Erlaubt: none, gzip.
language Nein string en Engine-Sprachschlüssel (2-16 Zeichen).
locale Nein string en-US Engine-Lokalisierungs-Schlüssel (2-20 Zeichen).
wheel Nein object {...} Optionen zum Rendern des Rades (siehe verschachtelte Tabelle).
theme Nein string classic Schlüssel zur Legacy-Kompatibilität, der auf wheel.theme abgebildet wird (classic->paper, light->day, dark->night, dark-high-contrast->obsidian).
lang Nein string en Schlüssel zur Legacy-Kompatibilität, der auf language abgebildet wird.
name Nein string User Legacy-Alias für user_name.
year Nein integer 1992 Legacy-geglättetes Geburtsjahr (verwenden Sie es zusammen mit month und day).
month Nein integer 7 Legacy-geglätteter Geburtsmonat.
day Nein Integer 16 Erforderliches, flaches Geburtsdatum.
hour Nein Integer 13 Erforderliche, flache Geburtszeit.
minute Nein Integer 45 Erforderliche, flache Geburtsminute.
lat Nein Zahl 40.7128 Erforderliches, flaches Breitengrad (muss mit lng übereinstimmen).
lng Nein Zahl -74.0060 Erforderliches, flaches Längengrad (muss mit lat übereinstimmen).
tz_str Nein String America/New_York Erforderliche, flache Zeitzonen-Alias.
city Nein String New York Erforderliches Kompatibilitätsfeld.
country Nein String US Erforderliches Kompatibilitätsfeld.

birth Objektfelder

Name Erforderlich Typ Beispiel Beschreibung
birth.date Ja (wenn birth angegeben ist) string 1992-07-16 Geburtsdatum (YYYY-MM-DD).
birth.time Nein string 13:45 Geburtszeit (HH:MM, 24-Stunden-Format).
birth.coordinates Nein object { "latitude": 40.7128, "longitude": -74.006 } Koordinaten-Objekt.
birth.coordinates.latitude Nein number 40.7128 Bereich: -90 bis 90.
birth.coordinates.longitude Nein number -74.0060 Bereich: -180 bis 180.
birth.timezone Nein string America/New_York IANA-Zeitzone.

wheel Objektfelder

Name Erforderlich Typ Beispiel Beschreibung
wheel.preset_id Nein string minimal_app Zulässig: minimal_app, editorial_full, print_clean.
wheel.preset_override_mode Nein string merge Zulässig: merge, preset_only.
wheel.size Nein integer 720 Bereich: 720 bis 2400.
wheel.theme Nein string paper Zulässig: night, day, aurora, paper, obsidian, sunset, zenith, mono.
wheel.panel_layout Nein string bottom Zulässig: right, bottom.
wheel.accent_color Nein string #3ddd77 Hex-Farbcode.
wheel.background_gradient Nein array[string] ["#0b1020", "#111b3b", "#1b2f6d"] Optionaler 3-Farb-Gradient Override.
wheel.panel_opacity Nein number 0.78 Bereich: 0.2 bis 1.0.
wheel.aspect_line_opacity Nein number 0.58 Bereich: 0.1 bis 1.0.
wheel.show_aspect_lines Nein boolean true Aspektlinien anzeigen.
wheel.show_house_cusps Nein boolean true Haus-Cusp-Marker anzeigen.
wheel.show_house_numbers Nein boolean true Hausnummern anzeigen.
wheel.show_sign_symbols Nein boolean true Tierkreiszeichen anzeigen.
wheel.show_sign_names Nein boolean true Tierkreis-Bezeichnungen anzeigen.
---
wheel.show_degree_ticks Nein boolean true Grad-Zählmarken anzeigen
wheel.show_degree_labels Nein boolean true Grad-Beschriftungen anzeigen
wheel.degree_tick_interval Nein integer 5 Bereich: 1 bis 30
wheel.show_planet_symbols Nein boolean true Planet-Symbole anzeigen
wheel.planet_symbol_size Nein number 15.0 Bereich: 10.0 bis 30.0
wheel.planet_marker_size Nein number 6.3 Bereich: 3.0 bis 12.0
wheel.show_planet_table Nein boolean true Planet-Tabelle-Panel anzeigen
wheel.show_aspect_table Nein boolean true Aspekt-Tabelle-Panel anzeigen
wheel.show_sign_legend Nein boolean true Zeichen-Legende anzeigen
wheel.show_element_balance Nein boolean true Element-Ausgleich-Panel anzeigen
wheel.show_metadata Nein boolean true Metadaten-Panel anzeigen
wheel.show_title Nein boolean true Titel/Untertitel anzeigen
wheel.show_angle_markers Nein boolean true ASC/MC-Marker anzeigen
wheel.show_center_signature Nein boolean true Center-Signatur-Text anzeigen
wheel.title Nein string Docs SVG Optionaler Rad-Titel
wheel.subtitle Nein string Expanded parity example Optionaler Rad-Untertitel
wheel.custom_planet_colors Nein object { "Sun": "#ffbb33" } Zuordnung von Planet-Name zu Hex-Farbe

Beispiel für den personalisierten Modus (Empfohlen)

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

Beispiel für den öffentlichen Modus (Allgemein, auf Basis von Signaturen)

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

Beispielantwort

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

Beispiele für gerendertes SVG

Druckvorlage (Merge Override) mit aktiven Seitenlinien

Print preset with aspect lines

Beispiel Tropical Zenith

Tropical zenith example

Beispiel mit dem Sidereal Obsidian API

Sidereal obsidian example