经典技法API文档（Klasik）

一次请求可同时计算多项经典技法：寿主星与辅助星（Hyleg / Alcocoden）、气质（四体液）、回归主星与年主星、Athla 十二劳绩圈、Animodar 出生时间校正、界时钟。请求中 techniques 里写哪项就算哪项。

基本信息

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

请求参数

1. 基础参数（必需）

参数名类型必选说明
data.datetimestring是出生时间，格式：YYYY-MM-DD HH:MM:SS
data.latnumber是出生地纬度
data.lonnumber是出生地经度
data.tznumber/string是出生地时区，如 8 表示UTC+8

2. techniques 订阅项（至少传一项；true 或带子参数的对象）

订阅项子参数说明
hyleg—寿主星（Hyleg）与辅助星（Alcocoden）：五生命点候选、寿地判定、尊贵计分、年值（大/中/小年）与凶星方向遭遇年表
temperamentno_birth_time（默认 false）气质：五因子各一票（日座元素/月相/升座元素/升座主/季节），no_birth_time=true 时不计后两项
lord_of_yearages（默认 [0..6]）回归主星（Dönüş Lordu）：出生时主星起按迦勒底序逐年；同时给出年主星（小限）、月宿主与特殊年标记
athlalot（"fortune" 默认 / "spirit"）Athla 十二劳绩圈：福点/精神点所在星座起整宫十二段及各段内天体
animodarrange.start / range.end（缺省为出生时刻前后2小时，最长48小时）Animodar 校正：出生前朔望度数之主（座主与尊贵主两法），分钟级扫描最接近该度数的 ASC / MC 时刻
dekanal_clockhours（默认 24，上限 48）界时钟：自 data.datetime 起一段时间内，上升点所落埃及界主星随时间的更换表

请求示例

{
    "data": {"datetime": "1990-09-04 14:47:00", "lat": 22.5431, "lon": 114.0579, "tz": 8},
    "techniques": {
        "hyleg": true,
        "temperament": true,
        "lord_of_year": {"ages": [0, 1, 2, 3, 4, 5, 6]},
        "athla": {"lot": "fortune"},
        "dekanal_clock": {"hours": 24}
    }
}

返回参数

返回 techniques 下与订阅项同名的对象：

字段说明
techniques.hylegday_chart(日夜盘)、positions(七行星黄经)、asc/mc、candidates(五候选：黄经/整宫宫位/寿地序号/是否入寿地)、hyleg{key,lon,aphetic_place}、alcocoden{winner,score,scores,rulers,tied,tie(平分及打破依据)}、years{type(major/average/minor),value,all,combust}、anaretic[](凶星方向遭遇：年数/相位/有力协助星/凶星状态)
techniques.temperamentscores(四气质各得分)、dominant/secondary(主/次气质)、factors[](五因子明细)、qualities(冷热干湿合计)、is_day、moon_phase_angle
techniques.lord_of_yearhour_lord(出生时主星)、day_lord(星期主星)、is_day、hour_number、rising_sign_index、moon_mansion(月宿1-28)、mansion_lord、years[]{age,turn_lord,profection_house,profection_sign_index,year_lord,great_turn,great_year,spirit_turn}
techniques.athlalot、anchor(起始点黄经)、anchor_sign_index、day_chart、sun_house_regiomontanus、athla_houses[]{athlon(1-12),sign_index,topic,bodies[](段内天体)}
techniques.animodarnatal{asc,mc}、segments[]{syzygy{is_new,lon,jd},domicile_ruler,almuten_ruler,methods_agree,results[]{method,planet,ruler_degree_in_sign,best_asc{jd,asc,deviation},best_mc{jd,mc,deviation},asc_candidates[],mc_candidates[]}}
techniques.dekanal_clockschedule[]{lord(界主星),sign,start/start_jd,end/end_jd}、changes(换界次数)

返回示例（节选）

{
    "success": true,
    "techniques": {
        "hyleg": {
            "day_chart": true,
            "hyleg": {"key": "Sun", "lon": 161.4921, "aphetic_place": 9, "aphetic_ok": true},
            "alcocoden": {"winner": "Mercury", "score": 9, "scores": {"Mercury": 9, "Venus": 6, ...}},
            "years": {"type": "minor", "value": 20, "combust": true, ...},
            "anaretic": [{"malefic": "Saturn", "target": "Alcocoden", "years": 25.7, ...}]
        },
        "temperament": {"scores": {"Choleric": 2, "Melancholic": 3, "Phlegmatic": 0, "Sanguine": 0},
                        "dominant": "Melancholic", "secondary": "Choleric", ...},
        "lord_of_year": {"hour_lord": "Sun", "day_lord": "Mars", "moon_mansion": 26,
                         "mansion_lord": "Jupiter", "years": [{"age": 0, "turn_lord": "Sun", ...}]},
        "athla": {"lot": "fortune", "anchor": 88.0, "athla_houses": [{"athlon": 1, "topic": "...", "bodies": ["Mars", "Fortune"]}, ...]},
        "dekanal_clock": {"changes": 60, "schedule": [{"lord": "Jupiter", "sign": "Capricorn", "start": "...", "end": "..."}]}
    }
}

使用说明

  • 行星名均为首字母大写英文（Sun / Moon / Mercury / Venus / Mars / Jupiter / Saturn）；气质名为 Choleric / Sanguine / Melancholic / Phlegmatic
  • animodar 的扫描区间按 data.tz 的本地时刻理解，扫描步长 1 分钟
  • hyleg 找不到入寿地候选时 hyleg 为 null（古典"anaretic 盘"情形），此时无 alcocoden 与年值
  • lord_of_year 的 ages 数值上限 120；dekanal_clock.hours 上限 48

Python 调用示例

import requests

response = requests.post('https://chart.12sign.top/spc/klasik', json={
    "data": {"datetime": "1990-09-04 14:47:00", "lat": 22.5431, "lon": 114.0579, "tz": 8},
    "techniques": {"hyleg": True, "temperament": True, "lord_of_year": {"ages": [0, 1, 2]}}
})
d = response.json()
h = d['techniques']['hyleg']
print("寿主星:", h['hyleg']['key'], "| 辅助星:", h['alcocoden']['winner'],
      "| 年值:", h['years']['value'], h['years']['type'])
print("气质:", d['techniques']['temperament']['dominant'])

在线测试

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