双盘API文档 - 本命盘vs太阳返照盘(多风格支持)
本命盘vs太阳返照盘接口用于生成本命盘与太阳返照盘的对比星盘。内圈显示本命盘,外圈显示指定年份的太阳返照盘位置,用于分析年度运势和主题。支持标准、经典、GD三种绘图风格,以及灵活的行星显示控制。
接口说明
本命盘vs太阳返照盘接口用于生成本命盘与太阳返照盘的对比星盘。内圈显示本命盘,外圈显示指定年份的太阳返照盘位置,用于分析年度运势和主题。
| 参数 | 值 |
|---|---|
| Base URL | https://chart.12sign.top |
| 接口URL | /bichart |
| 请求方式 | POST |
| Content-Type | application/json |
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| chart_type | String | 是 | 双盘类型,固定值:"natal_solarreturn" |
| data1 | Object | 是 | 本命盘数据(内圈) |
| data2 | Object | 是 | 太阳返照盘数据(外圈) |
| house_system | String | 是 | 宫位系统,例如:"P"(普拉西德)、"K"(科赫)、"E"(等宫制) |
行星显示优先级规则
⚠️ 重要:计算 vs 显示的区别
系统采用双层配置:计算层决定哪些天体被计算,显示层决定哪些天体在SVG中显示。
系统采用双层配置:计算层决定哪些天体被计算,显示层决定哪些天体在SVG中显示。
内圈(Chart1)显示优先级:
- inner_display_planets(如果明确传递)- 最高优先级,完全控制显示内容
- chart1_custom_*配置(如果有自定义配置)- 显示所有自定义计算的天体
- 默认系统设置(如果没有任何自定义配置)- 使用双盘类型的默认配置
外圈(Chart2)显示优先级:
- outer_display_planets(如果明确传递)- 最高优先级,完全控制显示内容
- chart2_custom_*配置(如果有自定义配置)- 显示所有自定义计算的天体
- 默认系统设置(如果没有任何自定义配置)- 使用双盘类型的默认配置
✅ 实际应用示例:
• 如果传递了
• 如果只传递了
• 这种设计允许用户精确控制视觉呈现,避免图表过于拥挤
• 如果传递了
chart1_custom_asteroids: [16, 201] 但 inner_display_planets: [0,1,2],则小行星会被计算但不会在SVG中显示• 如果只传递了
chart1_custom_asteroids: [16, 201] 而不传 inner_display_planets,则小行星会被计算并显示• 这种设计允许用户精确控制视觉呈现,避免图表过于拥挤
请求示例
{
"chart_type": "natal_solarreturn",
"data1": {
"datetime": "1990-01-01 12:00:00",
"lat": 39.9042,
"lon": 116.4074,
"tz": 8.0
},
"data2": {
"datetime": "2024-01-01 00:00:00",
"lat": 39.9042,
"lon": 116.4074,
"tz": 8.0
},
"house_system": "P"
}
返回参数
{
"success": true,
"data": { "chart_type": "natal_solarreturn" },
"svg": "<svg>...</svg>"
}
在线测试
请求地址:
https://chart.12sign.top/bichart
请求参数(JSON):
返回结果:
点击"发送请求"后在此显示结果
星盘图:
SVG星盘图将在请求成功后显示在这里