Doğum Haritası SVG Görüntüsü¶

Doğum Haritası SVG Görüntüsü uç noktası, yerleşik motor tarafından üretilen doğum tekerleği SVG çıktısını ve tam tekerlek/render seçeneği desteğini döndürür.

Dil desteği: 26 dilin tamamı desteklenir. İngilizce olmayan yanıtlar, çevirmen yardımcısı tarafından anında çevrilir (varsayılan olarak LibreTranslate; DeepL BYOK, MyMemory veya Google istek başına seçilebilir).

Uç Nokta¶

Yöntem	Yol
`POST`	`https://api.numerologyapi.com/api/v1/birth-chart/svg`

İstek Vücudu¶

Üst Seviye Alanlar| Ad | Gerekli | Tip | Örnek | Açıklama |¶

|---|---|---|---|---| | sign | Hayır | string | CANCER | Burç. İzin Verilenler: ARIES, TAURUS, GEMINI, CANCER, LEO, VIRGO, LIBRA, SCORPIO, SAGITTARIUS, CAPRICORN, AQUARIUS, PISCES. | | target_date | Hayır | string | 2026-04-08 | Kamu/geri dönüş tarihi (YYYY-MM-DD). | | birth | Hayır | nesne | {...} | Motor tarafından oluşturulan doğum bloğu (anahtarlı tabloya bakın). | | sections | Hayır | dizi[string] | ["general"] | İstenen bölümler. | | zodiac_system | Hayır | string | tropical | İzin Verilenler: sidereal, tropical. | | ayanamsa | Hayır | string | lahiri | İzin Verilenler: lahiri, fagan_bradley, krishnamurti, raman, yukteswar. | | house_system | Hayır | string | placidus | İzin Verilenler: placidus, whole_sign, equal, koch. | | node_type | Hayır | string | true | İzin Verilenler: true, mean. | | tenant_id | Hayır | string | docs-smoke | İsteğe bağlı tenant/cache namespace geçersiz kılma. | | user_name | Hayır | string | Docs Smoke User | Grafik oluşturmak için kullanıcı etiketi. | | output_mode | Hayır | string | wheel_only | İzin Verilenler: full, report_only, wheel_only. || include_wheel_svg | Hayır | boolean | true | Render yoluna tekerlek SVG dosyasını ekle. | | split | Hayır | boolean | false | false: İkili bir SVG yanıtı. true: Destekleniyorsa, bölünmüş JSON formatında bir SVG paketi oluştur. | | round_wheel_only | Hayır | boolean | true | Sadece dairesel bir tekerlek çizimi yap. | | transparent_background | Hayır | boolean | true | Şeffaf arka plan modu. | | svg_compression | Hayır | string | none | İzin Verilen: none, gzip. | | language | Hayır | string | en | Motor dili anahtarı (2-16 karakter). | | locale | Hayır | string | en-US | Motor yerel anahtarı (2-20 karakter). | | wheel | Hayır | nesne | {...} | Tekerlek çizim seçenekleri (iç içe tabloda bulunabilir). | | theme | Hayır | string | classic | Eski uyumluluk anahtarı, wheel.theme'a eşlenmiştir (classic->paper, light->day, dark->night, dark-high-contrast->obsidian). | | lang | Hayır | string | en | Eski uyumluluk anahtarı, language'ye eşlenmiştir. | | name | Hayır | string | User | user_name için eski kısaltma. | | year | Hayır | integer | 1992 | Eski düzleştirilmiş doğum yılı (month ve day ile birlikte kullanın). | | month | Hayır | integer | 7 | Eski düzleştirilmiş doğum ayı. || day | Hayır | tamsayı | 16 | Geçmiş doğum günü (düzleştirilmiş). || hour | No | integer | 13 | Legacy flattened birth hour. | | minute | Hayır | tamsayı | 45 | Geçmişteki düzleştirilmiş doğum dakikasının değeri. |

---| lat | Hayır | sayı | 40.7128 | Geleneksel, düzleştirilmiş enlem (lng ile eşleşmelidir). || lng | Hayır | sayı | -74.0060 | Geleneksel, düzleştirilmiş enlem (lat ile eşleşmelidir). || tz_str | Hayır | string | America/New_York | Geleneksel, düzleştirilmiş zaman dilimi kısaltması. || city | Hayır | string | New York | Eski uyumluluk alanı. || country | Hayır | string | US | Eski uyumluluk alanı. |

`birth` Nesne Alanları¶

Ad	Gerekli	Tip	Örnek	Açıklama
`birth.date`	Evet (`birth` sağlanmışsa)	string	`1992-07-16`	Doğum tarihi (`YYYY-MM-DD`).
`birth.time`	Hayır	string	`13:45`	Doğum saati (`HH:MM`, 24 saatlik formatta).
`birth.coordinates`	Hayır	nesne	`{ "latitude": 40.7128, "longitude": -74.006 }`	Koordinat bloğu.
`birth.coordinates.latitude`	Hayır	sayı	`40.7128`	Aralık: `-90`'den `90`'e.
`birth.coordinates.longitude`	Hayır	sayı	`-74.0060`	Aralık: `-180`'den `180`'ye.
`birth.timezone`	Hayır	string	`America/New_York`	IANA zaman dilimi.

`wheel` Nesne Alanları| Ad | Gerekli | Tür | Örnek | Açıklama |¶

|---|---|---|---|---| | wheel.preset_id | Hayır | string | minimal_app | Kabul Edilenler: minimal_app, editorial_full, print_clean. | | wheel.preset_override_mode | Hayır | string | merge | Kabul Edilenler: merge, preset_only. | | wheel.size | Hayır | integer | 720 | Aralık: 720 ile 2400 arasında. | | wheel.theme | Hayır | string | custom | Kabul Edilenler: night, day, aurora, paper, obsidian, sunset, zenith, mono, custom. Tam renk kontrolü için custom'ı wheel.theme_palette ile birlikte kullanın. | | wheel.panel_layout | Hayır | string | bottom | Kabul Edilenler: right, bottom. | | wheel.accent_color | Hayır | string | #3ddd77 | Hex renk kodu. | | wheel.background_gradient | Hayır | array[string] | ["#0b1020", "#111b3b", "#1b2f6d"] | İsteğe bağlı 3 renkli gradyanı geçersiz kılma. | | wheel.panel_opacity | Hayır | number | 0.78 | Aralık: 0.2 ile 1.0 arasında. | | wheel.theme_palette | Hayır | object | { "center_fill": "#0d1832", "panel_opacity": 0.78 } | İsteğe bağlı özel tema paleti geçersiz kılma (bkz. Özel Tekerlek Temaları). Kısmi geçersiz kılmalara her temada izin verilir; theme custom olduğunda gereklidir. | | wheel.aspect_line_opacity | Hayır | number | 0.58 | Aralık: 0.1 ile 1.0 arasında. | | wheel.show_aspect_lines | Hayır | boolean | true | Aspect çizgilerini göster. | | wheel.show_house_cusps | Hayır | boolean | true | Ev köşelerini göster. | | wheel.show_house_numbers | Hayır | boolean | true | Ev numaralarını göster. | | wheel.show_sign_symbols | Hayır | boolean | true | Zodyak sembollerini göster. | | wheel.show_sign_names | Hayır | boolean | true | Zodyak etiketlerini göster. | | wheel.show_degree_ticks | Hayır | boolean | true | Derece işaretlerini göster | | wheel.show_degree_labels | Hayır | boolean | true | Derece etiketlerini göster | | wheel.degree_tick_interval | Hayır | integer | 5 | Aralık: 1'den 30'ye | | wheel.show_planet_symbols | Hayır | boolean | true | Gezegen sembollerini göster | | wheel.planet_symbol_size | Hayır | sayı | 15.0 | Aralık: 10.0'den 30.0'e | | wheel.planet_marker_size | Hayır | sayı | 6.3 | Aralık: 3.0'den 12.0'ye | | wheel.show_planet_table | Hayır | boolean | true | Gezegen tablo panelini göster | | wheel.show_aspect_table | Hayır | boolean | true | Aspect tablo panelini göster | | wheel.show_sign_legend | Hayır | boolean | true | İşaret efsanesini göster | | wheel.show_element_balance | Hayır | boolean | true | Element denge panelini göster | | wheel.show_metadata | Hayır | boolean | true | Meta veri panelini göster | | wheel.show_title | Hayır | boolean | true | Başlığı/alt başlığı göster | | wheel.show_angle_markers | Hayır | boolean | true | ASC/MC işaretlerini göster | | wheel.show_center_signature | Hayır | boolean | true | Merkez imza metnini göster | | wheel.title | Hayır | string | Docs SVG | İsteğe bağlı tekerlek başlığını belirtin | | wheel.subtitle | Hayır | string | Expanded parity example | İsteğe bağlı tekerlek alt başlığını belirtin | | wheel.custom_planet_colors | Hayır | nesne | { "Sun": "#ffbb33" } | Gezegen adını hex-renkle eşleştirin | ``Bu uç nokta varsayılan olarak SVG (image/svg+xml) döndürür.split=true` durumunda, bölümlenmiş JSON SVG parçalarını da döndürebilir.

Özel Tekerlek Temaları (`theme: "custom"` + `theme_palette`)¶

Tekerleğin renkleri ve şeffaflığı tamamen özelleştirilebilir: wheel.theme değerini custom yapın ve bir theme_palette nesnesi iletin. Yalnızca sağladığınız anahtarlar geçersiz kılınır — geri kalan her şey koyu night temel paletine geri döner.

{
  "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` anahtarları¶

Anahtar	Tür	Ne kontrol eder
`bg_0` / `bg_1` / `bg_2`	hex (`#rrggbb`)	Arka plan gradyan durakları
`panel_fill`	hex	Gezegen/efsane paneli dolgusu
`panel_opacity`	float `0`–`1`	Panel şeffaflığı
`sign_line`	hex	Zodyak burç sınır çizgileri
`ring_inner`	hex	İç tekerlek halkası konturu
`center_fill`	hex	Tekerlek merkezi dolgusu (merkez imza diski)
`center_stroke`	hex	Tekerlek merkezi konturu
`divider`	hex	Ayırıcılar / kart kenarlıkları
`subtitle` / `text` / `soft_text`	hex	Tipografi renkleri

Kurallar¶

Kısmi geçersiz kılmalar — yalnızca sağladığınız anahtarlar uygulanır; geri kalanı temanın temel paletine geri döner (custom, koyu night temelini kullanır).
Renk değerleri 7 karakterli hex olmalıdır (#rrggbb); panel_opacity ise [0, 1] aralığında bir ondalık sayı olmalıdır. Bilinmeyen anahtarlar veya geçersiz değerler → 422 doğrulama hatası.
theme değeri "custom" olduğunda theme_palette zorunludur.
Adlandırılmış temalarda (örn. paper) theme_palette kısmi geçersiz kılma olarak çalışır.
Yalnızca tekerleğin görselleri değişir — harita hesaplamaları, konumlar ve açılar asla etkilenmez.

Özel tema örneği¶

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

Bu uç noktada eski `theme` önceliği¶

Eski üst düzey theme alanı hâlâ desteklenmektedir:

Açık üst düzey theme (örn. "theme": "dark") kazanır.
Aksi takdirde wheel.theme (örn. "custom" + theme_palette) kullanılır.
Aksi takdirde tarihsel varsayılan classic (→ paper) uygulanır.

Eski takma adlar: classic → paper, light → day, dark → night, dark-high-contrast → obsidian.

Kişiselleştirilmiş Mod Örneği (Önerilen)¶

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

Açık Mod Örneği (Genel İşaret Tabanlı)¶

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

Örnek Yanıt¶

Example birth chart SVG response

Render Edilmiş SVG Örnekleri¶

Yazdırma Ön Ayarı (Birleştirme Geçersiz Kılma) ile Aspect Çizgileri Etkin¶

Yazdırma ön ayarı ile aspect çizgileri

Tropikal Zenith Örneği¶

Tropikal zenith örneği

Sidereal Obsidian Örneği¶

Sidereal obsidian örneği