中国星座

根据出生日期计算中国生肖星座和年度运势预测。

---

中国生肖星座

根据出生年份计算某人的中国生肖星座和五行元素。

所需模块

需要 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 时）

中国生肖星座

十二年轮回的中国生肖动物：

星座	轮回年份（示例）
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

农历新年

中国生肖年从农历新年（每年一月下旬或二月初）开始，而非一月一日。一月或二月初出生的人可能属于上一个生肖年。

---

中国年度运势预测

根据某人的中国生肖星座计算年度运势预测。

所需模块

需要 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	财运预测