星座运势 API 文档

接口总览

基本信息

请求参数

请求体可为空（{}）或不传。

请求示例

POST https://chart.12sign.top/horoscopes
Content-Type: application/json

{}

返回参数

此外，data[] 还可能包含其他运势文本字段（如远端返回的解读文案等），具体以接口实际返回为准。

返回示例

{
  "status": "success",
  "data": [
    {
      "zodiac": "白羊座",
      "name": "白羊座",
      "sign": "Aries",
      "date": "20260805",
      "score_overall": 85,
      "score_love": 90,
      "score_career": 78,
      "score_money": 88,
      "score_health": 82,
      "lucky_color": "火焰红",
      "lucky_number": 9,
      "lucky_direction": "东南",
      "lucky_time": "09:00 - 11:00",
      "lucky_food": "川味火锅",
      "lucky_companion": "便携小镜子",
      "lucky_flower": "向日葵"
    }
    // ... 其余 11 个星座
  ]
}

星座对照表

cURL 调用示例

curl -X POST https://chart.12sign.top/horoscopes \
     -H "Content-Type: application/json" \
     -d '{}'

Python 测试代码示例

import requests

def test_horoscopes(base_url="https://chart.12sign.top"):
    url = f"{base_url}/horoscopes"
    try:
        print("正在测试12星座每日运势API...")
        response = requests.post(url, json={}, headers={'Content-Type': 'application/json'})
        print(f"响应状态码: {response.status_code}")
        if response.status_code == 200:
            data = response.json()
            print("API测试成功！")
            print(f"返回星座数量: {len(data.get('data', []))}")
            for item in data.get('data', []):
                print(f"\n=== {item['sign']} / {item['zodiac']} ({item['date']}) ===")
                print(f"综合分: {item.get('score_overall')}")
                print(f"爱情分: {item.get('score_love')}")
                print(f"事业分: {item.get('score_career')}")
                print(f"幸运色: {item.get('lucky_color')}")
            return data
        else:
            print(f"API请求失败: {response.status_code}")
            print(f"错误信息: {response.text}")
            return None
    except Exception as e:
        print(f"请求出错: {e}")
        return None

if __name__ == "__main__":
    test_horoscopes()

JavaScript (Fetch) 调用示例

fetch('https://chart.12sign.top/horoscopes', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({})
})
.then(res => res.json())
.then(data => {
    console.log('返回状态:', data.status);
    data.data.forEach(item => {
        console.log(`${item.sign} / ${item.zodiac} (${item.date})`);
        console.log('综合分:', item.score_overall);
        console.log('幸运色:', item.lucky_color);
    });
})
.catch(err => console.error('请求失败:', err));

在线测试

点击"发送请求"后在此显示结果

基本信息

请求参数

可选星座值

白羊座、金牛座、双子座、巨蟹座、狮子座、处女座、天秤座、天蝎座、射手座、摩羯座、水瓶座、双鱼座

请求示例

POST https://chart.12sign.top/horoscopes/day
Content-Type: application/json

{
  "zodiac": "白羊座"
}

返回参数

返回示例

{
  "zodiac": "白羊座",
  "date": "2026-08-05",
  "type": "day",
  "categorized_fortune": {
    "love": "爱情运势描述文本...",
    "career": "事业运势描述文本...",
    "money": "财运描述文本...",
    "health": "健康运势描述文本...",
    "study": "学业运势描述文本...",
    "mood": "心情运势描述文本...",
    "social": "人际运势描述文本...",
    "travel": "出行运势描述文本..."
  },
  "scores": {
    "love": 75,
    "career": 80,
    "wealth": 70,
    "study": 72,
    "health": 65,
    "overall": 74
  },
  "lucky_color": "玫瑰粉",
  "lucky_stone": "蓝宝石",
  "lucky_flower": "粉色郁金香",
  "lucky_food": "甜点",
  "lucky_number": 6,
  "lucky_direction": "正东方"
}

cURL 调用示例

curl -X POST https://chart.12sign.top/horoscopes/day \
     -H "Content-Type: application/json" \
     -d '{"zodiac": "白羊座"}'

# 指定日期
curl -X POST https://chart.12sign.top/horoscopes/day \
     -H "Content-Type: application/json" \
     -d '{"zodiac": "金牛座", "date": "2026-08-10"}'

Python 测试代码示例

import requests

def test_horoscope_day(base_url="https://chart.12sign.top"):
    url = f"{base_url}/horoscopes/day"
    payload = {"zodiac": "白羊座"}
    try:
        response = requests.post(url, json=payload, headers={'Content-Type': 'application/json'})
        print(f"响应状态码: {response.status_code}")
        if response.status_code == 200:
            data = response.json()
            print(f"星座: {data['zodiac']}  日期: {data['date']}  类型: {data['type']}")
            print(f"综合得分: {data['scores']['overall']}")
            for k, v in data['categorized_fortune'].items():
                print(f"{k}: {v[:30]}...")
            print(f"幸运色: {data['lucky_color']}  幸运数字: {data['lucky_number']}")
            return data
        else:
            print(f"请求失败: {response.text}")
            return None
    except Exception as e:
        print(f"请求出错: {e}")
        return None

if __name__ == "__main__":
    test_horoscope_day()

在线测试

点击"发送请求"后在此显示结果

基本信息

请求参数

请求示例

POST https://chart.12sign.top/horoscopes/month
Content-Type: application/json

{
  "zodiac": "双子座"
}

返回参数

返回示例

{
  "zodiac": "白羊座",
  "date": "2026-08",
  "type": "month",
  "categorized_fortune": {
    "love": "本月爱情运势描述...",
    "career": "本月事业运势描述...",
    "money": "本月财运描述...",
    "health": "本月健康运势描述...",
    "study": "本月学业运势描述...",
    "mood": "本月心情运势描述...",
    "social": "本月人际运势描述...",
    "travel": "本月出行运势描述..."
  },
  "scores": {
    "love": 75,
    "career": 80,
    "wealth": 70,
    "study": 72,
    "health": 65,
    "mood": 70,
    "social": 68,
    "travel": 73,
    "average": 74
  },
  "lucky_color": "玫瑰粉",
  "lucky_stone": "蓝宝石",
  "lucky_flower": "粉色郁金香",
  "lucky_food": "甜点",
  "lucky_number": 6,
  "lucky_direction": "正东方"
}

cURL 调用示例

curl -X POST https://chart.12sign.top/horoscopes/month \
     -H "Content-Type: application/json" \
     -d '{"zodiac": "双子座"}'

在线测试

点击"发送请求"后在此显示结果

基本信息

请求参数

可选星座值

白羊座、金牛座、双子座、巨蟹座、狮子座、处女座、天秤座、天蝎座、射手座、摩羯座、水瓶座、双鱼座

请求示例

POST https://chart.12sign.top/horoscopes/week
Content-Type: application/json

{
  "zodiac": "双子座"
}

返回参数

返回示例

{
  "zodiac": "白羊座",
  "date": "2026-W33",
  "type": "week",
  "categorized_fortune": {
    "love": "本周爱情运势描述...",
    "career": "本周事业运势描述...",
    "money": "本周财运描述...",
    "health": "本周健康运势描述...",
    "study": "本周学业运势描述...",
    "mood": "本周心情运势描述...",
    "social": "本周人际运势描述...",
    "travel": "本周出行运势描述..."
  },
  "scores": {
    "love": 75,
    "career": 80,
    "wealth": 70,
    "study": 72,
    "health": 65,
    "mood": 70,
    "social": 68,
    "travel": 73,
    "average": 74
  },
  "lucky_color": "玫瑰粉",
  "lucky_stone": "蓝宝石",
  "lucky_flower": "粉色郁金香",
  "lucky_food": "甜点",
  "lucky_number": 6,
  "lucky_direction": "正东方"
}

cURL 调用示例

curl -X POST https://chart.12sign.top/horoscopes/week \
     -H "Content-Type: application/json" \
     -d '{"zodiac": "双子座"}'

在线测试

点击"发送请求"后在此显示结果

基本信息

请求参数

请求示例

POST https://chart.12sign.top/horoscopes/year
Content-Type: application/json

{
  "zodiac": "狮子座"
}

返回参数

返回示例

{
  "zodiac": "白羊座",
  "date": "2026",
  "type": "year",
  "categorized_fortune": {
    "love": "本年爱情运势描述...",
    "career": "本年事业运势描述...",
    "money": "本年财运描述...",
    "health": "本年健康运势描述...",
    "study": "本年学业运势描述...",
    "mood": "本年心情运势描述...",
    "social": "本年人际运势描述...",
    "travel": "本年出行运势描述..."
  },
  "scores": {
    "love": 75,
    "career": 80,
    "wealth": 70,
    "study": 72,
    "health": 65,
    "mood": 70,
    "social": 68,
    "travel": 73,
    "average": 74
  },
  "lucky_color": "玫瑰粉",
  "lucky_stone": "蓝宝石",
  "lucky_flower": "粉色郁金香",
  "lucky_food": "甜点",
  "lucky_number": 6,
  "lucky_direction": "正东方"
}

cURL 调用示例

curl -X POST https://chart.12sign.top/horoscopes/year \
     -H "Content-Type: application/json" \
     -d '{"zodiac": "狮子座"}'

在线测试

点击"发送请求"后在此显示结果

错误响应 & 注意事项

HTTP 400 — 参数错误

{
  "error": "请提供有效的星座名称，可选: 白羊座, 金牛座, 双子座, 巨蟹座, 狮子座, 处女座, 天秤座, 天蝎座, 射手座, 摩羯座, 水瓶座, 双鱼座"
}

触发条件：

• 未提供 zodiac 参数
• zodiac 值不在可选范围内

HTTP 500 — 内部异常

{
  "error": "<异常详细信息>"
}

HTTP 404 — 运势未更新（仅 /horoscopes）

{
  "status": "error",
  "message": "今日运势还未更新"
}

HTTP 502 — 远端服务异常（仅 /horoscopes）

{
  "status": "error",
  "message": "请求远端服务失败: <具体错误信息>"
}