季节盘（入相）时刻API文档

返回指定公历年份太阳精确经过 0° / 90° / 180° / 270°（白羊、巨蟹、天秤、摩羯入相）的四个至点时刻，精确到秒。以该时刻为出生时间请求 /onechart 即可绘制对应季节盘。

基本信息

参数值
Base URLhttps://chart.12sign.top
接口URL/spc/ingress
请求方式POST
Content-Typeapplication/json

请求参数

参数名类型必选说明
yearinteger是公历年份，1500-2500
tznumber否（默认 0）仅用于回显 local 本地时间字符串；utc 与 jd 不受影响

请求示例

{
    "year": 2026,
    "tz": 8
}

返回参数

字段类型说明
yearinteger请求的年份
tznumber回显时区
ingresses[]array四季至点，按时间顺序（春/夏/秋/冬）
ingresses[].seasonstringaries / cancer / libra / capricorn
ingresses[].pointstringspring_eqinox（春分）/ summer_solstice（夏至）/ autumn_equinox（秋分）/ winter_solstice（冬至）
ingresses[].target_longitudenumber目标黄经（0 / 90 / 180 / 270）
ingresses[].jdnumber精确时刻的儒略日（UT）
ingresses[].utcstringUTC 时刻，YYYY-MM-DD HH:MM:SS
ingresses[].localstring/null本地时刻（传 tz 时返回，否则 null）

返回示例

{
    "success": true,
    "year": 2026,
    "tz": 8,
    "ingresses": [
        {"season": "aries", "point": "spring_eqinox", "target_longitude": 0.0,
         "jd": 2461090.1152546, "utc": "2026-03-20 14:45:58", "local": "2026-03-20 22:45"},
        {"season": "cancer", "point": "summer_solstice", "target_longitude": 90.0,
         "jd": 2461192.3503588, "utc": "2026-06-21 08:24:31", "local": "2026-06-21 16:24"},
        {"season": "libra", "point": "autumn_equinox", "target_longitude": 180.0,
         "jd": 2461286.0036829, "utc": "2026-09-23 00:05:14", "local": "2026-09-23 08:05"},
        {"season": "capricorn", "point": "winter_solstice", "target_longitude": 270.0,
         "jd": 2461375.8682253, "utc": "2026-12-21 20:50:15", "local": "2026-12-22 04:50"}
    ]
}

使用说明

  • utc / jd 为黄经精确到秒的时刻，可直接作为 /onechart 的 data（时间取 utc 并传对应 tz）绘制季节盘
  • local 为 UTC+tz 的近似显示（到分钟），如需精确本地秒可自行用 utc 换算

Python 调用示例

import requests

response = requests.post('https://chart.12sign.top/spc/ingress', json={"year": 2026, "tz": 8})
d = response.json()
for i in d['ingresses']:
    print(i['season'], i['utc'], i['local'])

在线测试

请求地址：
https://chart.12sign.top/spc/ingress
请求参数（JSON）：
返回结果：
点击"发送请求"后在此显示结果