次限推运盘API文档

接口说明

本接口用于生成次限推运盘，需要提供本命盘数据和推运目标时间/地点信息，计算并绘制次限推运星盘图。次限推运是一种重要的预测技术，每一天代表人生的一年。

基本信息

• 接口URL： /onechart
• 请求方式： POST
• Content-Type： application/json

请求参数

请求示例

{
        "chart_type": "progression_sec",
        "natal_data": {
        "datetime": "1990-01-01 12:00:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": "8.0"
        },
        "target_data": {
        "datetime": "2024-03-01 12:00:00",
        "lat": 31.2304,
        "lon": 121.4737,
        "tz": "8.0"
        },
        "house_system": "P",
        "use_chinese_font": true,
						"include_svg":true,
        }

返回参数

返回示例

{
        "success": true,
        "data": {
        "chart_type": "progression_sec",
        "planets": [
            {"name": "sun", "degree": 280.5, ...},
            {"name": "moon", "degree": 125.3, ...},
            ...
        ],
        "houses": [
            {"house": 1, "degree": 45.2, ...},
            {"house": 2, "degree": 75.8, ...},
            ...
        ]
        },
        "svg": ""
        }

Python测试代码示例

import requests
import json
import os
from datetime import datetime, timedelta

class ProgressionSecAPITest:
    def __init__(self, base_url="http://chart.12sign.top"):
        self.base_url = base_url
        self.endpoint = f"{base_url}/onechart"
        
        # 创建输出目录
        self.output_dir = "test_chart_outputs"
        if not os.path.exists(self.output_dir):
            os.makedirs(self.output_dir)
    
    def test_progression_sec_chart(self):
        """测试次限推运盘API"""
        payload = {
            "chart_type": "progression_sec",
            "natal_data": {
                "datetime": "1990-01-01 12:00:00",
                "lat": 39.9042,
                "lon": 116.4074,
                "tz": "8.0"
            },
            "target_data": {
                "datetime": "2024-01-01 12:00:00",
                "lat": 39.9042,
                "lon": 116.4074,
                "tz": "8.0"
            },
            "house_system": "P",
            "use_chinese_font": True
        }
        
        try:
            print(f"正在测试次限推运盘API: {self.endpoint}")
            print(f"请求数据: {json.dumps(payload, indent=2, ensure_ascii=False)}")
            
            response = requests.post(
                self.endpoint,
                json=payload,
                headers={'Content-Type': 'application/json'}
            )
            
            print(f"响应状态码: {response.status_code}")
            
            if response.status_code == 200:
                result = response.json()
                print("次限推运盘API测试成功！")
                print(f"返回数据包含: {list(result.keys())}")
                print("完整的返回数据：")
                print(result)
                # 保存SVG文件
                if 'svg' in result and result['svg']:
                    svg_filename = os.path.join(self.output_dir, 'progression_sec_chart_test.svg')
                    with open(svg_filename, 'w', encoding='utf-8') as f:
                        f.write(result['svg'])
                    print(f"SVG文件已保存: {svg_filename}")
                else:
                    print("警告: 响应中没有SVG数据")
                
                return result
            else:
                print(f"API请求失败: {response.status_code}")
                print(f"错误信息: {response.text}")
                return None
                
        except requests.exceptions.RequestException as e:
            print(f"请求错误: {e}")
            return None
        except json.JSONDecodeError as e:
            print(f"JSON解析错误: {e}")
            return None
        except Exception as e:
            print(f"未知错误: {e}")
            return None

def test_progression_sec_api():
    """简化的次限推运盘API测试函数"""
    import requests
    import json
    import os
    
    # API配置
    base_url = "http://chart.12sign.top"
    api_url = f"{base_url}/onechart"
    
    # 测试数据
    payload = {
        "chart_type": "progression_sec",
        "natal_data": {
            "datetime": "1990-01-01 12:00:00",
            "lat": 39.9042,
            "lon": 116.4074,
            "tz": "8.0"
        },
        "target_data": {
            "datetime": "2024-01-01 12:00:00",
            "lat": 39.9042,
            "lon": 116.4074,
            "tz": "8.0"
        },
        "house_system": "P",
        "use_chinese_font": True
    }
    
    try:
        print("正在测试次限推运盘API...")
        response = requests.post(api_url, json=payload, headers={'Content-Type': 'application/json'})
        print(f"响应状态码: {response.status_code}")
        
        if response.status_code == 200:
            data = response.json()
            print("次限推运盘API测试成功！")
            print(f"返回数据包含: {list(data.keys())}")
            
            # 保存SVG文件
            if 'svg' in data and data['svg']:
                os.makedirs('test_outputs', exist_ok=True)
                with open('test_outputs/progression_sec_test.svg', 'w', encoding='utf-8') as f:
                    f.write(data['svg'])
                print("SVG文件已保存: test_outputs/progression_sec_test.svg")
            
            return data
        else:
            print(f"API请求失败: {response.status_code}")
            print(f"错误信息: {response.text}")
            return None
            
    except Exception as e:
        print(f"请求出错: {e}")
        return None

if __name__ == "__main__":
    test_progression_sec_api()

注意事项