Aller au contenu

Retour astrologique

L'endpoint Retour astrologique explique le concept des retours planétaires, en mettant en évidence comment chaque retour représente une nouvelle phase dans la vie d'une personne.

Les retours peuvent fournir des informations sur la croissance personnelle, les opportunités et les événements clés de la vie, en fonction du planéta impliqué.

Idéal pour les passionnés d'astrologie, les interprètes de cartes et tous ceux qui cherchent à comprendre le moment des cycles de vie dans leur thème natal.

Endpoint

Méthode Chemin
GET https://api.numerologyapi.com/api/v1/horoscope/astrology/returns
POST https://api.numerologyapi.com/api/v1/horoscope/astrology/returns

Paramètres de requête

Nom Obligatoire Type Exemple Description
returns ✅ Chaîne solar Nom du retour astrologique. Valeurs prises en charge : solar, lunar, mercury, venus, mars, jupiter, saturn.

Note

La présence de paramètres manquants ou invalides entraînera une erreur 400. Les méthodes GET et POST sont prises en charge.

Ajoutez le paramètre de requête optionnel lang pour localiser les réponses. Valeurs prises en charge : en, es, de, fr, pt.

Exemples de requêtes

Requête 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"

Requête 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"
}'

Exemple de réponse

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

Ouvrir le tableau de bord

Note

Champs de réponse :

  • returns — Nom du retour astrologique
  • definition — Explication générale des retours planétaires et de leur signification
  • returns_summary — Description détaillée du retour planétaire sélectionné

Endpoints connexes