星宿API文档（二十七宿）

接口说明

本接口用于计算二十七宿星宿：根据出生日期时间与地点，返回本命星宿（含宿名、梵名、pada步、六曜）、值日星宿、三九秘宿、本命宿与值日宿的关系解读；传入 info=宿名 可返回该宿的档案资料（四象、守护神、五行、性格、运势）；另有 /mansion27svg 接口直接返回二十七宿轮盘SVG图。

基本信息

请求参数

请求示例

# 计算星宿数据（1990-01-01 12:00 北京）
GET https://chart.12sign.top/mansion27?year=1990&month=1&day=1&hour=12&minute=0&lon=116.4&lat=39.9&tz=8

# 获取二十七宿轮盘SVG
GET https://chart.12sign.top/mansion27svg?year=1990&month=1&day=1&hour=12&minute=0&lon=116.4&lat=39.9&tz=8

# 查询某宿的档案（如 虚宿）
GET https://chart.12sign.top/mansion27?info=虚宿

返回参数

返回示例

{
    "system": "宿曜道27宿(等宽 12.857 度,恒星黄道,月亮定宿;与七政28宿今制不同体系)",
    "本命宿": {
    "宿": "虚宿",
    "梵名": "Dhanishta",
    "pada": 3,
    "月亮恒星黄经": 305.07,
    "六曜": "赤口"
    },
    "三九秘宿": {
    "分类": "衰",
    "含义": "解恶、治病等可，不宜遠行、遷移、買賣、裁衣、剃頭、剪甲"
    },
    "值日宿": {
    "宿": "虚宿",
    "梵名": "Dhanishta",
    "pada": 3,
    "月亮恒星黄经": 305.07,
    "六曜": "赤口"
    },
    "本命宿→值日宿关系": {
    "距离": 0,
    "关系": "命",
    "含义": "本命同宿"
    }
    }

Python测试代码示例

import requests

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

def test_mansion27():
    params = {
        "year": 1990, "month": 1, "day": 1,
        "hour": 12, "minute": 0,
        "lon": 116.4, "lat": 39.9, "tz": 8
    }
    # 1. 星宿数据
    r = requests.get(f"{BASE}/mansion27", params=params)
    data = r.json()
    print(f"本命宿: {data['本命宿']['宿']} ({data['本命宿']['梵名']}) "
          f"pada {data['本命宿']['pada']} 六曜 {data['本命宿']['六曜']}")
    print(f"三九秘宿: {data['三九秘宿']['分类']} - {data['三九秘宿']['含义']}")

    # 2. 本命宿档案
    r = requests.get(f"{BASE}/mansion27", params={"info": data['本命宿']['宿']})
    print(f"档案: {r.json().get('mansion27Info')}")

    # 3. 轮盘SVG
    r = requests.get(f"{BASE}/mansion27svg", params=params)
    with open("mansion27_wheel.svg", "w", encoding="utf-8") as f:
        f.write(r.text)
    print("轮盘SVG已保存: mansion27_wheel.svg")

if __name__ == "__main__":
    test_mansion27()

在线测试

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