合盘API接口文档 - Synastry双盘API、关系兼容性分析API

接口说明

合盘（Synastry）接口用于生成两个人的星盘对比。内圈显示第一个人的星盘，外圈显示第二个人的星盘，用于分析两人之间的关系兼容性和互动模式。

请求参数

参数名 类型 必填 说明
chart_type String 是 双盘类型，固定值："synastry"
data1 Object 是 第一个人的星盘数据（内圈）
data2 Object 是 第二个人的星盘数据（外圈）
house_system String 是 宫位系统，例如："P"（普拉西德）
include_svg Boolean 否 是否包含SVG图像，默认true

data1和data2的参数结构

参数名 类型 必填 说明
datetime String 是 日期时间，格式："YYYY-MM-DD HH:MM:SS"
lat Number 是 纬度，范围：-90到90
lon Number 是 经度，范围：-180到180
tz Number 是 时区偏移，例如：8.0（东八区）

请求示例

        {
        "chart_type": "synastry",
        "data1": {
        "datetime": "1990-01-01 12:00:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": 8.0
        },
        "data2": {
        "datetime": "1992-06-15 14:30:00",
        "lat": 31.2304,
        "lon": 121.4737,
        "tz": 8.0
        },
        "house_system": "P",
        "include_svg": true
        }

返回参数

参数名 类型 说明
success Boolean 请求是否成功
data Object 星盘数据
data.chart_type String 双盘类型："synastry"
data.house_cusps Array 宫头位置数组（12个元素）
data.chart1_planets Object 第一个人的行星位置数据
data.chart2_planets Object 第二个人的行星位置数据
svg String SVG格式的星盘图像（当include_svg为true时）
message String 响应消息

返回示例

        {
        "success": true,
        "data": {
        "chart_type": "synastry",
        "house_cusps": [0.0, 30.0, 60.0, 90.0, 120.0, 150.0, 180.0, 210.0, 240.0, 270.0, 300.0, 330.0],
        "chart1_planets": {
            "Sun": {"longitude": 280.123, "speed": 1.0},
            "Moon": {"longitude": 45.678, "speed": 13.2}
        },
        "chart2_planets": {
            "Sun": {"longitude": 84.456, "speed": 1.0},
            "Moon": {"longitude": 220.789, "speed": 13.1}
        }
        },
        "svg": "...",
        "message": "双盘计算成功"
        }

注意事项

  • 时间格式必须为 YYYY-MM-DD HH:MM:SS 或 YYYY-MM-DD HH:MM
  • 时区格式为数字，东时区为正数，西时区为负数
  • chart_type必须设置为"synastry"
  • data1为第一个人的星盘数据（内圈），data2为第二个人的星盘数据（外圈）
  • 两个人可以有不同的出生时间和地点
  • 合盘主要用于分析两人之间的关系兼容性
  • 宫位系统通常以第一个人（data1）的星盘为准
  • 返回的行星位置包含经度和速度信息