马克思三限推运API文档

基本信息

接口功能说明、注意事项、通用参数（动态天体配置、恒星、阿拉伯点等）请参考 单盘接口通用参数说明

请求参数

1. 基础参数（必需）

请求示例

基础请求示例

{
  "chart_type": "marks_tertiary",
  "data": {
    "datetime": "1979-11-06 09:55:00",
    "lat": 39.9042,
    "lon": 116.4074,
    "tz": 8
  },
  "data2": {
    "datetime": "1985-03-15 14:30:00",
    "lat": 31.2304,
    "lon": 121.4737,
    "tz": 8
  },
  "target_data": {
    "datetime": "2024-01-15 12:00:00",
    "lat": 39.9042,
    "lon": 116.4074,
    "tz": 8
  },
  "house_system": "P",
  "include_svg": true,
  "include_analysis": true
}

高级配置示例

{
  "chart_type": "marks_tertiary",
  "data": {
    "datetime": "1979-11-06 09:55:00",
    "lat": 39.9042,
    "lon": 116.4074,
    "tz": 8
  },
  "data2": {
    "datetime": "1985-03-15 14:30:00",
    "lat": 31.2304,
    "lon": 121.4737,
    "tz": 8
  },
  "target_data": {
    "datetime": "2024-01-15 12:00:00",
    "lat": 39.9042,
    "lon": 116.4074,
    "tz": 8
  },
  "house_system": "P",
  "include_svg": true,
  "include_analysis": true,
  "chart_style": "gd",
  "theme": "dark",
  "dynamic_planet_config": {
    "level": "modern_complete",
    "custom_asteroids": [1, 2, 3, 4],
    "custom_arabic_parts": ["AP0001", "AP0002"]
  },
  "include_fixed_star": "important",
  "fixed_stars_in_svg": ["conjunction", "opposition"],
  "orb_scheme": "tight"
}

响应格式

成功响应结构

{
  "success": true,
  "data": {
    "chart_type": "marks_tertiary",
    "calculation_time": "2024-01-15T12:00:00Z",
    "house_system": "P",
    "planets": {
      "SUN": {
        "name": "太阳",
        "longitude": 245.67,
        "latitude": 0.12,
        "speed": 0.95,
        "sign": "Sagittarius",
        "house": 11,
        "retrograde": false
      },
      ...
    },
    "houses": {
      "House_1": {"longitude": 15.23, "sign": "Aries"},
      "House_2": {"longitude": 45.67, "sign": "Taurus"},
      ...
    },
    "aspects": [
      {
        "planet1": "SUN",
        "planet2": "MOON",
        "angle": 180,
        "orb": 2.5,
        "type": "opposition",
        "applying": false
      },
      ...
    ],
    "fixed_stars": {
      "Sirius": {
        "longitude": 104.06,
        "latitude": -39.66,
        "magnitude": -1.46,
        "aspects": [...]
      },
      ...
    },
    "arabic_parts": {
      "Part_of_Fortune": {
        "longitude": 189.34,
        "sign": "Libra",
        "house": 7
      },
      ...
    },
    "analysis": {
      "element_distribution": {
        "fire": 3,
        "earth": 2,
        "air": 4,
        "water": 1
      },
      "quality_distribution": {
        "cardinal": 2,
        "fixed": 3,
        "mutable": 5
      },
      "hemisphere_emphasis": {
        "eastern": 6,
        "western": 4,
        "northern": 5,
        "southern": 5
      },
      "chart_ruler": "Jupiter",
      "dominant_element": "air",
      "dominant_quality": "mutable"
    }
  },
  "svg": "<svg>...SVG星盘图内容...</svg>",
  "metadata": {
    "calculation_time": "2024-01-15T12:00:00Z",
    "house_system": "P",
    "chart_style": "gd",
    "theme": "dark",
    "total_planets": 15,
    "total_aspects": 23,
    "fixed_stars_calculated": 17,
    "arabic_parts_calculated": 8
  }
}

交互式接口额外返回数据

{
  "success": true,
  "data": {
    // ... 标准数据 ...
    "coordinates": {
      "planets": {
        "SUN": {"x": 245.67, "y": 0.12},
        "MOON": {"x": 89.34, "y": 5.67},
        ...
      },
      "house_cusps": {
        "cusp1": {"x": 15.23, "y": 0},
        "cusp2": {"x": 45.67, "y": 0},
        ...
      },
      "aspect_lines": [
        {
          "planet1": "SUN",
          "planet2": "MOON",
          "angle": "opposition",
          "x1": 245.67, "y1": 0.12,
          "x2": 89.34, "y2": 5.67
        },
        ...
      ]
    }
  },
  // ... 其他响应数据 ...
}

错误处理

常见错误响应

{
  "success": false,
  "error": "错误类型",
  "message": "详细错误信息",
  "details": {
    "field": "具体字段",
    "value": "错误值",
    "expected": "期望值"
  }
}

错误类型说明

在线测试

点击"发送请求"后在此显示结果