泛音盘API文档（Harmonic）
泛音盘（谐波盘）：将本命各行星黄经乘以泛音阶数 n（mod 360）得到的新盘，返回泛音行星位置、宫位、相位表，可选附带年龄点（Age Point），可选返回 SVG 盘面。走 /onechart 主接口，chart_type 传 harmonic。
基本信息
| 参数 | 值 |
|---|---|
| Base URL | https://chart.12sign.top |
| 接口URL | /onechart |
| 请求方式 | POST |
| Content-Type | application/json |
请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
| chart_type | string | 是 | 固定 harmonic |
| data1 | object | 是 | 本命数据：{datetime, lat, lon, tz} |
| harmonic_n | number | 否（默认 4） | 泛音阶数 n，如 4 / 5 / 7 / 9 |
| harmonic_house_mode | string | 否（默认 addey） | 泛音宫位推导模式：addey（按本命宫位比例推导） |
| house_system | string | 否（默认 P） | 本命宫位制字母（推导输入用） |
| age_point_when | string | 否 | YYYY-MM-DD HH:MM:SS；传入则同时返回该时刻的年龄点（84 年周期） |
| include_svg | boolean | 否（默认 false） | 是否返回泛音盘 SVG |
| display_aspects / custom_orbs / orb_scheme / theme / use_chinese_font | — | 否 | 与单盘通用参数一致（相位筛选/容许度/主题等） |
请求示例
{
"chart_type": "harmonic",
"data1": {"datetime": "1990-09-04 14:47:00", "lat": 22.5431, "lon": 114.0579, "tz": 8},
"harmonic_n": 9,
"age_point_when": "2026-01-01 12:00:00",
"include_svg": false
}返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| data.chart_type | string | "harmonic" |
| data.harmonic | number | 泛音阶数 n |
| data.house_mode | string | 宫位推导模式 |
| data.planets | object | 十大行星泛音位置：{NAME: {longitude(黄经), speed(速率×n), retrograde, sign(中文星座), house(宫位)}} |
| data.houses | object | {House_1..House_12: {longitude}} 泛音宫头 |
| data.aspects[] | array | 泛音位置上的相位：{planet1, planet2, aspect, orb, movement} |
| data.age_point | object | 传 age_point_when 时返回：{lon(黄经), pos(度数文本), age_years(周岁), cycle_years(84)} |
| svg | string/null | include_svg=true 时的盘面 SVG |
返回示例（节选）
{
"success": true,
"data": {
"chart_type": "harmonic",
"harmonic": 9.0,
"house_mode": "addey",
"planets": {
"SUN": {"longitude": 13.429, "speed": 8.87, "retrograde": false,
"sign": "白羊", "house": 1},
...
},
"houses": {"House_1": {"longitude": ...}, ...},
"aspects": [
{"planet1": "SUN", "planet2": "MOON", "aspect": "Conjunction", "orb": 3.21, "movement": "..."},
...
],
"age_point": {"lon": 151.3979, "pos": "处女 1°24′", "age_years": 35.3262, "cycle_years": 84.0}
},
"svg": null
}使用说明
- 泛音黄经 = 本命黄经 × n (mod 360)；例：本命太阳 161.49° 的第 9 泛音 = 161.49×9 mod 360 = 13.43°（白羊 13.43°）
- 星座名返回中文（白羊…双鱼），与单盘 natal 响应同形状，前端可复用渲染逻辑
- include_svg=true 时 SVG 内嵌占星字体，与单盘盘面风格一致
Python 调用示例
import requests
response = requests.post('https://chart.12sign.top/onechart', json={
"chart_type": "harmonic",
"data1": {"datetime": "1990-09-04 14:47:00", "lat": 22.5431, "lon": 114.0579, "tz": 8},
"harmonic_n": 9,
"age_point_when": "2026-01-01 12:00:00"
})
d = response.json()['data']
print("第9泛音太阳:", d['planets']['SUN']['longitude'], d['planets']['SUN']['sign'])
print("年龄点:", d['age_point']['pos'])在线测试
请求地址：
https://chart.12sign.top/onechart
请求参数（JSON）：
返回结果：
点击"发送请求"后在此显示结果