Gambar SVG Bagan Kelahiran¶

Endpoint Gambar SVG Bagan Kelahiran mengembalikan output SVG roda kelahiran dari mesin internal dengan dukungan penuh untuk opsi roda/render.

Dukungan bahasa: Semua 26 bahasa didukung. Respons non-Bahasa Inggris diterjemahkan secara langsung oleh helper penerjemah (default LibreTranslate; DeepL BYOK, MyMemory, atau Google dapat dipilih per permintaan).

Endpoint¶

Badan Permintaan¶

Bidang Tingkat Atas| Nama | Diperlukan | Tipe | Contoh | Deskripsi |¶

|---|---|---|---|---| | sign | Tidak | string | CANCER | Tanda zodiak. Pilihan: ARIES, TAURUS, GEMINI, CANCER, LEO, VIRGO, LIBRA, SCORPIO, SAGITTARIUS, CAPRICORN, AQUARIUS, PISCES. | | target_date | Tidak | string | 2026-04-08 | Tanggal cadangan publik/sign (YYYY-MM-DD). | | birth | Tidak | objek | {...} | Blok kelahiran mesin (lihat tabel bersarang). | | sections | Tidak | array[string] | ["general"] | Bagian yang diminta. | | zodiac_system | Tidak | string | tropical | Pilihan: sidereal, tropical. | | ayanamsa | Tidak | string | lahiri | Pilihan: lahiri, fagan_bradley, krishnamurti, raman, yukteswar. | | house_system | Tidak | string | placidus | Pilihan: placidus, whole_sign, equal, koch. | | node_type | Tidak | string | true | Pilihan: true, mean. | | tenant_id | Tidak | string | docs-smoke | Override namespace penyewa/cache (opsional). | | user_name | Tidak | string | Docs Smoke User | Label pengguna untuk pembuatan grafik. | | output_mode | Tidak | string | wheel_only | Pilihan: full, report_only, wheel_only. |--- REVISED TRANSLATION --- | include_wheel_svg | Tidak | boolean | true | Sertakan artefak SVG roda dalam jalur render. | | split | Tidak | boolean | false | false: respons SVG biner. true: gabungkan bundel SVG JSON saat didukung. | | round_wheel_only | Tidak | boolean | true | Hanya render roda berbentuk lingkaran. | | transparent_background | Tidak | boolean | true | Mode latar belakang transparan. | | svg_compression | Tidak | string | none | Diizinkan: none, gzip. | | language | Tidak | string | en | Kunci bahasa mesin (2-16 karakter). | | locale | Tidak | string | en-US | Kunci lokal mesin (2-20 karakter). | | wheel | Tidak | object | {...} | Opsi render roda (lihat tabel bersarang). | | theme | Tidak | string | classic | Kunci kompatibilitas lama yang dipetakan ke wheel.theme (classic->paper, light->day, dark->night, dark-high-contrast->obsidian). | | lang | Tidak | string | en | Kunci kompatibilitas lama yang dipetakan ke language. | | name | Tidak | string | User | Alias lama untuk user_name. | | year | Tidak | integer | 1992 | Tahun kelahiran yang telah diratakan secara warisan (gunakan dengan month dan day). | | month | Tidak | integer | 7 | Bulan kelahiran yang telah diratakan secara warisan. || day | Tidak | integer | 16 | Tanggal kelahiran (versi lama). | | hour | Tidak | integer | 13 | Jam kelahiran (versi lama). | | minute | Tidak | integer | 45 | Menit kelahiran (versi lama). | | lat | Tidak | angka | 40.7128 | Garis lintang (versi lama) (harus dipasangkan dengan lng). | | lng | Tidak | angka | -74.0060 | Garis bujur (versi lama) (harus dipasangkan dengan lat). | | tz_str | Tidak | string | America/New_York | Alias zona waktu (versi lama). | | city | Tidak | string | New York | Bidang kompatibilitas (versi lama). | | country | Tidak | string | US | Bidang kompatibilitas (versi lama). |

birth Bidang Objek| Nama | Wajib | Tipe | Contoh | Deskripsi |¶

|------|----------|------|---------|-------------| | birth.date | Ya (jika birth disediakan) | string | 1992-07-16 | Tanggal lahir (YYYY-MM-DD). | | birth.time | Tidak | string | 13:45 | Waktu kelahiran (HH:MM, dalam format 24 jam). | | birth.coordinates | Tidak | objek | { "latitude": 40.7128, "longitude": -74.006 } | Blok koordinat. | | birth.coordinates.latitude | Tidak | angka | 40.7128 | Rentang: -90 hingga 90. | | birth.coordinates.longitude | Tidak | angka | -74.0060 | Rentang: -180 hingga 180. | | birth.timezone | Tidak | string | America/New_York | Zona waktu IANA. |

Bidang Objek `wheel````markdown¶

Tema Roda Kustom (theme: "custom" + theme_palette)¶

Warna dan transparansi roda sepenuhnya dapat disesuaikan: atur wheel.theme menjadi custom dan berikan objek theme_palette. Hanya kunci yang Anda berikan yang akan ditimpa — sisanya kembali ke palet dasar night yang gelap.

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

Kunci theme_palette¶

Aturan¶

• Override parsial — hanya kunci yang Anda berikan yang diterapkan; sisanya kembali ke palet dasar tema (custom menggunakan dasar night gelap).
• Nilai warna harus berupa hex 7 karakter (#rrggbb); panel_opacity harus berupa float dalam [0, 1]. Kunci yang tidak dikenal atau nilai tidak valid → kesalahan validasi 422.
• theme_palette wajib saat theme adalah "custom".
• Pada tema bernama (mis. paper), theme_palette berfungsi sebagai override parsial.
• Hanya visual roda yang berubah — perhitungan bagan, posisi, dan aspek tidak pernah terpengaruh.

Contoh tema kustom¶

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

Prioritas theme lama pada endpoint ini¶

Bidang theme tingkat atas yang lama masih didukung:

1. theme tingkat atas eksplisit (mis. "theme": "dark") menang.
2. Jika tidak, wheel.theme (mis. "custom" + theme_palette) digunakan.
3. Jika tidak, default historis classic (→ paper) berlaku.

Alias lama: classic → paper, light → day, dark → night, dark-high-contrast → obsidian.

Contoh Mode Personalisasi (Direkomendasikan)¶

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

Contoh Mode Publik (Berdasarkan Tanda)¶

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

Contoh Respons¶

Contoh SVG yang Dirender¶

Pengaturan Cetak (Gabungkan Override) Dengan Garis Aspek Diaktifkan¶

Contoh Tropical Zenith¶

Contoh Sidereal Obsidian¶