Информация об астрологических возвратах¶
Конечная точка Astrology Returns объясняет концепцию планетных возвратов, выделяя, как каждый возврат представляет собой новый цикл в жизни человека. Возвраты могут предоставить информацию о личностном росте, возможностях и ключевых событиях в жизни, в зависимости от участвующей планеты.
Идеально подходит для любителей астрологии, интерпретаторов карт и всех, кто хочет понять временные рамки жизненных циклов в своей натальной карте.
Конечная точка¶
| Метод | Путь |
|---|---|
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— Подробное описание выбранной транзитной фазы