Китайский гороскоп

Расчёт знаков китайского зодиака и годовых прогнозов по дате рождения человека.

---

Знак китайского зодиака

Расчёт знака китайского зодиака и элемента человека по году рождения.

Необходимый модуль

Требуется модуль chinese-horoscope:calc.

curl -X POST "https://api.astroapi.cloud/api/calc/chinese-horoscope" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15",
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

Параметры

Параметр	Тип	Обязателен	Описание
birthDate	string	Да	Дата рождения в формате YYYY-MM-DD
language	string	Нет	Код языка для текстового контента (по умолчанию: "en")
includeText	boolean	Нет	Включить текст интерпретации (по умолчанию: false)
includeReadableEntities	boolean	Нет	Включить читаемые названия знака и элемента (по умолчанию: false)

Ответ

{
    "data": {
        "sign": "horse",
        "element": "metal",
        "year": 1990,
        "signTitle": "Horse",
        "elementTitle": "Metal",
        "text": "People born in the Year of the Horse are energetic, active, and enjoy being in a crowd. They are quick to learn and love adventure..."
    }
}

Поля ответа

Поле	Тип	Описание
sign	string	Знак китайского зодиака
element	string	Связанный элемент (wood, fire, earth, metal, water)
year	number	Год рождения, использованный для расчёта
signTitle	string | null	Читаемое название знака (только если includeReadableEntities: true)
elementTitle	string | null	Читаемое название элемента (только если includeReadableEntities: true)
text	string | null	Текст интерпретации (только если includeText: true)

Знаки китайского зодиака

12-летний цикл животных китайского зодиака:

Знак	Годы цикла (примеры)
rat	1948, 1960, 1972, 1984, 1996, 2008, 2020
ox	1949, 1961, 1973, 1985, 1997, 2009, 2021
tiger	1950, 1962, 1974, 1986, 1998, 2010, 2022
rabbit	1951, 1963, 1975, 1987, 1999, 2011, 2023
dragon	1952, 1964, 1976, 1988, 2000, 2012, 2024
snake	1953, 1965, 1977, 1989, 2001, 2013, 2025
horse	1954, 1966, 1978, 1990, 2002, 2014, 2026
goat	1955, 1967, 1979, 1991, 2003, 2015, 2027
monkey	1956, 1968, 1980, 1992, 2004, 2016, 2028
rooster	1957, 1969, 1981, 1993, 2005, 2017, 2029
dog	1958, 1970, 1982, 1994, 2006, 2018, 2030
pig	1959, 1971, 1983, 1995, 2007, 2019, 2031

Китайский Новый год

Год китайского зодиака начинается с китайского Нового года (конец января или начало февраля), а не с 1 января. Даты рождения в январе или начале февраля могут относиться к предыдущему году зодиака.

---

Китайский годовой прогноз

Расчёт годового прогноза для человека на основе его знака китайского зодиака.

Необходимый модуль

Требуется модуль chinese-forecast:calc.

curl -X POST "https://api.astroapi.cloud/api/calc/chinese-forecast" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15",
    "forecastYear": 2024,
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

Параметры

Параметр	Тип	Обязателен	Описание
birthDate	string	Да	Дата рождения в формате YYYY-MM-DD
forecastYear	number	Нет	Год для составления прогноза (по умолчанию: текущий год)
language	string	Нет	Код языка для текстового контента (по умолчанию: "en")
includeText	boolean	Нет	Включить текст интерпретации (по умолчанию: false)
includeReadableEntities	boolean	Нет	Включить читаемое название знака (по умолчанию: false)

Ответ

{
    "data": {
        "sign": "horse",
        "year": 2024,
        "signTitle": "Horse",
        "text": "The Year of the Dragon 2024 brings dynamic energy to the Horse. Your natural charisma is amplified this year, drawing new opportunities and connections into your life...",
        "categories": {
            "Love": "This year brings exciting romantic possibilities. Single Horses may meet someone special through social activities. Those in relationships will find new depth and understanding...",
            "Career": "Professional growth is highlighted in 2024. Your innovative ideas gain recognition, and a promotion or new opportunity may present itself mid-year...",
            "Health": "Pay attention to stress levels and ensure adequate rest. Regular exercise and a balanced diet will help maintain your characteristically high energy levels...",
            "Finance": "Financial prospects improve steadily through 2024. Avoid impulsive spending in the first quarter, and by mid-year you will be in a stronger position to invest..."
        }
    }
}

Поля ответа

Поле	Тип	Описание
sign	string	Знак китайского зодиака
year	number	Год прогноза
signTitle	string | null	Читаемое название знака (только если includeReadableEntities: true)
text	string | null	Общий текст годового прогноза (только если includeText: true)
categories	object	Прогноз по сферам жизни
categories.Love	string	Прогноз по романтике и отношениям
categories.Career	string	Прогноз по карьере и профессии
categories.Health	string	Прогноз по здоровью и самочувствию
categories.Finance	string	Финансовый прогноз