七政四余排盘API文档

接口说明

本接口用于七政四余排盘：根据出生日期时间与地点，计算四柱、十一星曜（日月五星四余的星次、西座、星度、宿度、黄经、顺逆等）、十二宫（宫位地支、宫头度数、神煞）、神煞、大限年限、择日、今制/古制宿度、张果星宗格局断语等完整盘面与解读；/svg 返回七政四余星盘SVG图（可带 transitYear 推运年份，流年环神煞、当年四化随之变化）。

基本信息

请求参数

请求示例

# 盘面解读（1990-01-01 12:00 北京）
GET https://chart.12sign.top/qizheng/interpret?year=1990&month=1&day=1&hour=12&minute=0&lon=116.4&lat=39.9&tz=8

# 获取七政四余星盘SVG（带2026推运年）
GET https://chart.12sign.top/qizheng/svg?year=1990&month=1&day=1&hour=12&minute=0&lon=116.4&lat=39.9&tz=8&transitYear=2026

返回参数（/interpret）

返回示例

{
    "sections": [
    {
        "title": "起盘",
        "rows": [
        { "label": "起盘时间", "value": "1990-01-01 12:00:00" },
        { "label": "时区", "value": "UTC+8" }
        ]
    },
    {
        "title": "四柱",
        "rows": [
        { "label": "年柱", "value": "庚午" },
        { "label": "月柱", "value": "戊子" }
        ]
    },
    {
        "title": "星曜",
        "rows": [
        { "label": "太阳", "value": "星次：丑宫(星紀)；西座：摩羯；星度：10.47°；宿度：斗0.30°；黄经：280.47°；状态：顺行" }
        ]
    },
    ...
    ],
    "zhangguo": [
    {
        "entry_id": 396,
        "star": "月",
        "branch": "子",
        "reading_type": "合格",
        "description": "月在子宫，月明斗府，主文章冠世，官居翰苑。",
        "note": "補遺格局"
    }
    ],
    "ruleStarNotes": {
    "三台": ["贵显之曜，主科甲、地位、仪仗……"],
    ...
    }
    }

Python测试代码示例

import requests

BASE = "https://chart.12sign.top/qizheng"

def test_qizheng():
    params = {
        "year": 1990, "month": 1, "day": 1,
        "hour": 12, "minute": 0,
        "lon": 116.4, "lat": 39.9, "tz": 8
    }
    # 1. 盘面解读
    data = requests.get(f"{BASE}/interpret", params=params).json()
    for sec in data["sections"]:
        print(f"\n=== {sec['title']} ===")
        for row in sec["rows"][:3]:
            print(f"{row['label']}: {row['value']}")
    print(f"\n张果格局数: {len(data['zhangguo'])}")

    # 2. 星盘SVG（带推运年）
    r = requests.get(f"{BASE}/svg", params={**params, "transitYear": 2026})
    with open("qizheng.svg", "w", encoding="utf-8") as f:
        f.write(r.text)
    print("星盘SVG已保存: qizheng.svg")

if __name__ == "__main__":
    test_qizheng()

在线测试

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