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.

Sprachunterstützung: Alle 26 Sprachen werden unterstützt. Antworten, die nicht auf Englisch sind, werden vom Übersetzungsassistenten in Echtzeit übersetzt (LibreTranslate als Standard; DeepL BYOK, MyMemory oder Google pro Anfrage wählbar).

Endpunkt¶

Anforderungs-Body¶

Oberhalb liegende Felder¶

birth Objektfelder¶

wheel Objektfelder¶

|| num_sys | string | No | Optional numerology system. Supported values: pythagorean, chaldean, vedic. Aliases also supported. Defaults to pythagorean. |¶

| 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 |This endpoint returns SVG (image/svg+xml) by default. It can return split JSON SVG parts when split=true.

Benutzerdefinierte Rad-Themes (theme: "custom" + theme_palette)¶

Farben und Transparenz des Rades sind vollständig anpassbar: Setzen Sie wheel.theme auf custom und übergeben Sie ein theme_palette-Objekt. Nur die Schlüssel, die Sie angeben, werden überschrieben – alles andere fällt auf die dunkle night-Basis-Palette zurück.

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

theme_palette-Schlüssel¶

Regeln¶

• Partielle Überschreibungen — nur die von Ihnen angegebenen Schlüssel werden angewendet; der Rest fällt auf die Basis-Palette des Themes zurück (custom verwendet die dunkle night-Basis).
• Farbwerte müssen 7-stellige Hex-Werte (#rrggbb) sein; panel_opacity muss eine Gleitkommazahl in [0, 1] sein. Unbekannte Schlüssel oder ungültige Werte → 422-Validierungsfehler.
• theme_palette ist erforderlich, wenn theme gleich "custom" ist.
• Bei benannten Themes (z. B. paper) fungiert theme_palette als partielle Überschreibung.
• Nur die visuelle Darstellung des Rades ändert sich — Chart-Berechnungen, Positionen und Aspekte sind nie betroffen.

Beispiel für ein benutzerdefiniertes Theme¶

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

Legacy-theme-Priorität auf diesem Endpunkt¶

Das alte Top-Level-Feld theme wird weiterhin unterstützt:

1. Ein explizites Top-Level-theme (z. B. "theme": "dark") gewinnt.
2. Andernfalls wird wheel.theme (z. B. "custom" + theme_palette) verwendet.
3. Andernfalls greift die historische Standardeinstellung classic (→ paper).

Legacy-Aliasse: classic → paper, light → day, dark → night, dark-high-contrast → obsidian.

Beispiel für den personalisierten Modus (Empfohlen)¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/birth-chart/svg?num_sys=pythagorean"" \
  --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
  }
,
  "num_sys": "pythagorean"
}'

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

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/birth-chart/svg?num_sys=pythagorean"" \
  --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 }
,
  "num_sys": "pythagorean"
}'

Beispielantwort¶

Beispiele für gerendertes SVG¶

Druckvorlage (Merge Override) mit aktiven Seitenlinien¶

Beispiel Tropical Zenith¶

Beispiel mit dem Sidereal Obsidian API¶