双盘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中显示。

内圈(Chart1)显示优先级:

  1. inner_display_planets(如果明确传递)- 最高优先级,完全控制显示内容
  2. chart1_custom_*配置(如果有自定义配置)- 显示所有自定义计算的天体
  3. 默认系统设置(如果没有任何自定义配置)- 使用双盘类型的默认配置

外圈(Chart2)显示优先级:

  1. outer_display_planets(如果明确传递)- 最高优先级,完全控制显示内容
  2. chart2_custom_*配置(如果有自定义配置)- 显示所有自定义计算的天体
  3. 默认系统设置(如果没有任何自定义配置)- 使用双盘类型的默认配置
✅ 实际应用示例:
• 如果传递了 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星盘图将在请求成功后显示在这里