Sari la conținut

Retururi Astrologice

Endpoint-ul Retururi Astrologice explică conceptul de retur planetar, evidențiind cum fiecare retur reprezintă un nou ciclu în viața unei persoane. Retururile pot oferi informații despre creștere personală, oportunități și evenimente cheie din viață, în funcție de planeta implicată.

Ideal pentru pasionații de astrologie, interpreți de grafuri și oricine dorește să înțeleagă momentul ciclurilor de viață din harta natală.

Endpoint

Metodă Cale
GET https://api.numerologyapi.com/api/v1/horoscope/astrology/returns
POST https://api.numerologyapi.com/api/v1/horoscope/astrology/returns

Parametri de Interogare

Nume Obligatoriu Tip Exemplu Descriere
returns ✅ String solar Numele returului astrologic. Valori acceptate: solar, lunar, mercury, venus, mars, jupiter, saturn.

Notă

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

Adăugați parametrul de interogare opțional lang pentru a localiza răspunsurile. Valori acceptate: en, es, de, fr, pt.

Exemple de Cereri

Cerere 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"

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

Exemplu de Răspuns

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

---Deschide panoul de control

Notă

Câmpuri de răspuns:

  • returns — Numele rezultatului astrologic
  • definition — Explicație generală a rezultatelor planetare și semnificația lor în viață
  • returns_summary — Descriere detaliată a rezultatului planetar selectat

Endpoint-uri conexe