صورة مخطط الميلاد SVG¶

نقطة نهاية صورة مخطط الميلاد SVG تُرجع مخرجات SVG للمحور الولادي من المحرك الداخلي مع دعم كامل للخيارات الكاملة/العرض.

دعم اللغة: جميع اللغات الـ 26 مدعومة. تُترجم الردود غير الإنجليزية على الفور بواسطة مساعد الترجمة (LibreTranslate افتراضيًا؛ ويمكن تحديد DeepL BYOK أو MyMemory أو Google لكل طلب).

نقطة النهاية¶

نص الطلب¶

الحقول على مستوى العليا| الاسم | مطلوب | النوع | مثال | الوصف |¶

|---|---|---|---|---| | sign | لا | سلسلة | CANCER | علامة الأبراج. القيم المسموح بها: ARIES, TAURUS, GEMINI, CANCER, LEO, VIRGO, LIBRA, SCORPIO, SAGITTARIUS, CAPRICORN, AQUARIUS, PISCES. | | target_date | لا | سلسلة | 2026-04-08 | تاريخ الإرجاع العام أو الاحتياطي (YYYY-MM-DD). | | birth | لا | كائن | {...} | كتلة الميلاد الأصلية للمحرك (انظر الجدول الفرعي). | | sections | لا | مصفوفة من السلاسل | ["general"] | الأقسام المطلوبة. | | zodiac_system | لا | سلسلة | tropical | القيم المسموح بها: sidereal, tropical. | | ayanamsa | لا | سلسلة | lahiri | القيم المسموح بها: lahiri, fagan_bradley, krishnamurti, raman, yukteswar. | | house_system | لا | سلسلة | placidus | القيم المسموح بها: placidus, whole_sign, equal, koch. | | node_type | لا | سلسلة | true | القيم المسموح بها: true, mean. | | tenant_id | لا | سلسلة | docs-smoke | قيمة اختيارية لتجاوز مساحة الاسم للمستأجر أو التخزين المؤقت. | | user_name | لا | سلسلة | Docs Smoke User | تسمية المستخدم لعرض الرسم البياني. | | output_mode | لا | سلسلة | wheel_only | القيم المسموح بها: full, report_only, wheel_only. || include_wheel_svg | لا | قيمة منطقية | true | تضم ملف SVG الخاص بـ "عجلة" في مسار العرض. |

---| split | لا | قيمة منطقية | false | false: استجابة SVG ثنائية. true: حزمة SVG JSON مقسمة عند الدعم. || round_wheel_only | لا | قيمة منطقية | true | عرض عجلة دائرية فقط. || transparent_background | لا | قيمة منطقية | true | وضع خلفية شفافة. || svg_compression | لا | سلسلة نصية | none | مسموح به: none, gzip. || language | لا | سلسلة نصية | en | مفتاح لغة المحرك (2-16 حرفًا). || locale | لا | سلسلة نصية | en-US | مفتاح موقع محرك (2-20 حرفًا). || wheel | لا | كائن | {...} | خيارات عرض العجلات (انظر الجدول المتداخل). || theme | لا | سلسلة نصية | classic | مفتاح التوافق مع الإصدارات القديمة، مرتبط بـ wheel.theme (classic->paper, light->day, dark->night, dark-high-contrast->obsidian). || lang | لا | سلسلة نصية | en | مفتاح التوافق مع الإصدارات القديمة، مرتبط بـ language. || name | لا | سلسلة نصية | User | اسم مستعار قديم لـ user_name. |

---| year | لا | عدد صحيح | 1992 | سنة الميلاد الأصلية (يستخدم مع month و day). || month | لا | عدد صحيح | 7 | شهر الميلاد الأصلي بعد التوحيد. || day | لا | عدد صحيح | 16 | تاريخ الميلاد القديم والموحد. || hour | No | integer | 13 | Legacy flattened birth hour. | | minute | لا | عدد صحيح | 45 | دقيقة الميلاد التقليدية والمسطحة. || lat | لا | رقم | 40.7128 | خط عرض مسطح قديم (يجب أن يتوافق مع lng). || lng | لا | رقم | -74.0060 | خطوط الطول المستوية القديمة (يجب أن يتطابق مع lat). || tz_str | لا | سلسلة نصية | America/New_York | اسم مستعار لـ "توقيت المنطقة" القديم والمسطح. || city | لا | سلسلة نصية | New York | حقل توافق الإصدارات القديمة. || country | لا | سلسلة نصية | US | حقل توافق الإصدارات القديمة. |

حقول الكائن birth¶

حقول كائن wheel| الاسم | مطلوب | النوع | مثال | الوصف |¶

|---|---|---|---|---| | wheel.preset_id | لا | سلسلة نصية | minimal_app | مسموح به: minimal_app، editorial_full، print_clean. | | wheel.preset_override_mode | لا | سلسلة نصية | merge | مسموح به: merge، preset_only. | | wheel.size | لا | عدد صحيح | 720 | النطاق: من 720 إلى 2400. | | wheel.theme | لا | سلسلة نصية | custom | مسموح به: night، day، aurora، paper، obsidian، sunset، zenith، mono، custom. استخدم custom مع wheel.theme_palette للتحكم الكامل في الألوان. | | wheel.panel_layout | لا | سلسلة نصية | bottom | مسموح به: right، bottom. | | wheel.accent_color | لا | سلسلة نصية | #3ddd77 | لون سداسي عشري. | | wheel.background_gradient | لا | مصفوفة[سلسلة نصية] | ["#0b1020", "#111b3b", "#1b2f6d"] | خيار لتجاوز التدرج اللوني بثلاثة ألوان. | | wheel.panel_opacity | لا | رقم | 0.78 | النطاق: من 0.2 إلى 1.0. | | wheel.theme_palette | لا | كائن | { "center_fill": "#0d1832", "panel_opacity": 0.78 } | تجاوز اختياري للوحة ألوان مخصصة (انظر موضوعات العجلة المخصصة). يُسمح بالتجاوز الجزئي على أي موضوع؛ مطلوب عندما تكون قيمة theme هي custom. | | wheel.aspect_line_opacity | لا | رقم | 0.58 | النطاق: من 0.1 إلى 1.0. | | wheel.show_aspect_lines | لا | قيمة منطقية | true | عرض خطوط الزاوية. | | wheel.show_house_cusps | لا | قيمة منطقية | true | عرض علامات نقاط نهاية المنزل. | | wheel.show_house_numbers | لا | قيمة منطقية | true | عرض أرقام المنازل. | | wheel.show_sign_symbols | لا | قيمة منطقية | true | عرض رموز الأبراج. | | wheel.show_sign_names | لا | قيمة منطقية | true | عرض تسميات الأبراج. |--- REVISED TRANSLATION --- | wheel.show_degree_ticks | لا | قيمة منطقية | true | إظهار علامات الدرجات. | | wheel.show_degree_labels | لا | قيمة منطقية | true | إظهار تسميات الدرجات. | | wheel.degree_tick_interval | لا | عدد صحيح | 5 | النطاق: من 1 إلى 30. | | wheel.show_planet_symbols | لا | قيمة منطقية | true | إظهار رموز الكواكب. | | wheel.planet_symbol_size | لا | رقم | 15.0 | النطاق: من 10.0 إلى 30.0. | | wheel.planet_marker_size | لا | رقم | 6.3 | النطاق: من 3.0 إلى 12.0. | | wheel.show_planet_table | لا | قيمة منطقية | true | إظهار لوحة جدول الكواكب. | | wheel.show_aspect_table | لا | قيمة منطقية | true | إظهار لوحة جدول الجوانب. | | wheel.show_sign_legend | لا | قيمة منطقية | true | إظهار أسطورة العلامات. | | wheel.show_element_balance | لا | قيمة منطقية | true | إظهار لوحة توازن العناصر. | | wheel.show_metadata | لا | قيمة منطقية | true | إظهار لوحة البيانات الوصفية. | | wheel.show_title | لا | قيمة منطقية | true | إظهار العنوان/العنوان الفرعي. | | wheel.show_angle_markers | لا | قيمة منطقية | true | إظهار علامات ASC/MC. | | wheel.show_center_signature | لا | قيمة منطقية | true | إظهار نص توقيع المركز. | | wheel.title | لا | سلسلة نصية | Docs SVG | عنوان العجلة الاختياري. | | wheel.subtitle | لا | سلسلة نصية | Expanded parity example | عنوان فرعي للعجلة الاختياري. | | wheel.custom_planet_colors | لا | كائن | { "Sun": "#ffbb33" } | خريطة من اسم الكوكب إلى لون سداسي عشري. |This endpoint returns SVG (image/svg+xml) by default. It can return split JSON SVG parts when split=true.

موضوعات العجلة المخصصة (theme: "custom" + theme_palette)¶

ألوان العجلة وشفافيتها قابلة للتخصيص بالكامل: اضبط wheel.theme على custom ومرر كائن theme_palette. يتم تجاوز المفاتيح التي تقدمها فقط — أما كل ما عدا ذلك فيُستخدم مع اللوحة الأساسية الداكنة night.

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

القواعد¶

• التجاوز الجزئي — يتم تطبيق المفاتيح التي تقدمها فقط؛ أما الباقي فيعود إلى اللوحة الأساسية للموضوع (custom يستخدم الأساس الداكن night).
• يجب أن تكون قيم الألوان hex من 7 أحرف (#rrggbb)؛ ويجب أن يكون panel_opacity رقمًا عشريًا ضمن [0, 1]. المفاتيح غير المعروفة أو القيم غير الصالحة → خطأ تحقق 422.
• theme_palette مطلوب عندما يكون theme هو "custom".
• على الموضوعات المسماة (مثل paper) يعمل theme_palette كتجاوز جزئي.
• تتغير المظاهر المرئية للعجلة فقط — الحسابات والمواقع والجوانب لا تتأثر أبدًا.

مثال على موضوع مخصص¶

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

أولوية theme القديم على هذه النقطة النهائية¶

لا يزال حقل theme القديم على المستوى الأعلى مدعومًا:

1. theme الصريح على المستوى الأعلى (مثل "theme": "dark") له الأولوية.
2. وإلا يتم استخدام wheel.theme (مثل "custom" + theme_palette).
3. وإلا يتم تطبيق القيمة الافتراضية التاريخية classic (→ paper).

الأسماء المستعارة القديمة: classic → paper, light → day, dark → night, dark-high-contrast → obsidian.

مثال الوضع المخصص (موصى به)¶

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

مثال الوضع العام (يعتمد على العلامات)¶

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

مثال للرد¶

--- نهاية المثال ---

أمثلة SVG المُولَّدة¶

إعداد الطباعة المسبقة (دمج التجاوز) مع تمكين خطوط الأبعاد¶

مثال نقطة الانعكاس الاستوائية¶

مثال أوبيسديان سماوي¶