معلومات حول علم التنجيم¶

نقطة النهاية "معلومات حول علم التنجيم" تشرح مفهوم "تكرار الكواكب"، مع التركيز على كيف يمثل كل تكرار دورة جديدة في حياة الشخص. يمكن أن توفر التكرارات رؤى حول النمو الشخصي والفرص والأحداث الرئيسية في الحياة، اعتمادًا على الكوكب المعني.

هذه الموارد مثالية لعشاق علم التنجيم ومحللي الخرائط وأي شخص يسعى لفهم توقيت دورات الحياة في خريطته الميلاد.

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

الطريقة	المسار
`GET`	`https://api.numerologyapi.com/api/v1/horoscope/astrology/returns`
`POST`	`https://api.numerologyapi.com/api/v1/horoscope/astrology/returns`

معلمات الاستعلام¶

الاسم	مطلوب	النوع	مثال	الوصف
`returns`	✅	سلسلة نصية	`solar`	اسم تكرار علم التنجيم. القيم المدعومة: `solar`، `lunar`، `mercury`، `venus`، `mars`، `jupiter`، `saturn`.

ملاحظة

Missing or invalid parameters will return a 400 error.
Both GET and POST methods are supported.

يمكن إضافة معلم الاستعلام الاختياري lang لترجمة الردود. القيم المدعومة: en، es، de، fr، pt.

أمثلة على الطلبات¶

طلب GET¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/horoscope/astrology/returns?returns=solar&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

طلب POST¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/horoscope/astrology/returns?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "returns": "solar"
}'

مثال على الرد¶

{
  "return_type": "solar",
  "full_name": "Solar Return",
  "cycle_duration": "≈1 year (exact birthday to next birthday)",
  "symbolic_meaning": "Annual rebirth of the Sun — your personal New Year chart",
  "what_it_activates": "Core identity, life purpose, vitality, conscious direction for the coming year",
  "key_themes": [
    "Overall tone of the year",
    "Where you shine / seek recognition",
    "Major focus areas (look at SR Ascendant + Sun house)"
  ],
  "psychological_focus": "Evolving sense of self, confidence levels, how you want to be seen",
  "spiritual_growth_opportunity": "Aligning ego with soul purpose, stepping into authentic leadership",
  "common_challenges_shadow": [
    "Ego inflation/deflation",
    "Burnout from over-identification with external success",
    "Fear of not being 'enough'"
  ],
  "highest_expression": "Radiant authentic presence, joyful creative contribution",
  "affirmation": "I shine from my true center. This year I live my purpose with courage and joy.",
  "recommended_rituals_practices": [
    "Cast & interpret Solar Return chart near birthday",
    "Sun salutations on birthday",
    "Golden candle ritual for vitality",
    "Vision board for the year ahead"
  ],
  "common_challenges": [
    "Ego inflation/deflation",
    "Burnout from over-identification with external success",
    "Fear of not being 'enough'"
  ],
  "recommended_practices": [],
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "90f458dfe1aafa13",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "horoscope_astrology_returns",
    "endpoint_description": "Calculates planetary returns (Solar, Lunar, etc.).",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:50.607044+01:00",
    "data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "es",
      "de",
      "fr",
      "pt"
    ],
    "notes": ""
  }
}

---فتح لوحة التحكم

ملاحظة

حقول الاستجابة:

returns — اسم النتيجة الفلكية
definition — شرح عام لنتائج الكواكب وأهميتها في الحياة
returns_summary — وصف تفصيلي للنتيجة الفلكية المختارة