免费的星盘api系统

理解AI星盘占星接口服务根据搜索结果和AI星盘的背景信息，AI星盘是一家专注于占星服务的平台，提供专业的星盘排盘、星座资讯、运势分析和占星教程。API 文档（api_docs_index.html）通常是为开发者设计的，允许他们通过编程方式调用AI星盘的占星计算和分析功能。以下是该 API 可能涵盖的核心内容（基于典型占星 API 结构和AI星盘的特点）：接口功能：星盘生成：提供生成个人本命盘、合盘（如比较盘、组合中点盘）、推运盘（如行运盘、太阳返照盘）等的功能，输入出生信息（日期、时间、地点）即可返回星盘数据。
星体与参数计算：支持计算十大主行星（太阳至冥王星）、小行星（如凯龙星、爱神星）、恒星（高达134颗）、阿拉伯点（177个）等的位置和相位。
合盘分析：提供双人合盘评分功能，分析两人关系（如爱情、合作）的兼容性，输出详细的星盘解读或评分结果。
古典占星支持：包括先天尊贵、宫神星、互容接纳等古典占星参数，以及日出日落时间、星盘格局（如大三角、T三角）计算。
星历表与查询：支持查询星相日历（公元0年至3600年）和其他占星数据。

技术特性：数据格式：API 通常以 JSON 或 XML 格式返回星盘数据，便于开发者解析和集成。
灵活参数：支持自定义星盘样式、容许度设置、语言切换（简体/繁体）等。
离线支持：可能提供部分离线计算能力，适合无网络环境。
开放性：如合盘评分功能的公开计分细节，增强透明度和可信度。

使用场景：开发者可将 API 集成到占星类应用、网站或工具中，为用户提供个性化的星盘分析服务。
适用于占星师、星座爱好者或需要批量处理星盘数据的场景。

功能介绍：合盘评分接口功能名称：双人合盘评分接口
功能描述：
AI星盘的合盘评分接口允许开发者通过输入两个人的出生信息（包括公历出生日期、时间和地点），生成双人合盘（如比较盘、组合中点盘、时空中点盘等），并返回两人关系的兼容性评分及详细解读。该接口结合现代和古典占星学，分析星体相位、宫位分布、特殊点（如南北交点、莉莉丝）和古典参数（如互容接纳、赤纬平行），提供精准的缘分评估。接口支持灵活的参数配置，例如星盘样式、容许度设置和语言选择，输出结果以 JSON 格式返回，包含评分详情、共性分析和潜在问题建议，适用于爱情、友情或合作关系分析。
应用场景： 占星类 APP 或网站，用于为用户提供情侣配对或人际关系分析。
占星师工具，快速生成和分析客户合盘数据。
社交平台，增加趣味性的星座缘分测试功能。
示例调用：
输入：两人出生信息（JSON 格式）
输出：合盘评分（0-100 分）、星盘数据、解读文本（如“火星与金星的和谐相位表明强烈的吸引力”）。

功能介绍：九宫格与日运、周运、月运接口功能名称：九宫格星盘与运势预测接口
功能描述：
AI星盘的九宫格与运势预测接口为开发者提供了一种便捷的方式，通过 API 调用生成简化的星盘视图（九宫格形式）以及日运、周运、月运的个性化运势分析。 九宫格接口：开发者可输入用户的出生信息（公历日期、时间、地点），生成一个九宫格格式的星盘数据，展示核心星体（如太阳、月亮、上升星座）、宫位分布或关键相位信息。输出数据以 JSON 格式返回，包含星座、宫位、相位角度等，适合前端渲染为直观的九宫格图表，便于用户快速了解星盘概况。
日运接口：根据用户本命盘和指定日期，计算行星的实时位置（如太阳行一度约一天，月亮行一度约两小时）及其与本命盘的相位，生成当日的运势解读，涵盖情感、事业、财运等主题。例如，可分析金星进入5宫对当天爱情运的影响。
周运接口：基于一周内行星的移动和相位变化（如木星行一度约12天），生成周度运势预测，重点分析关键宫位（如7宫关系、10宫事业）的动态，提供详细的运势建议。
月运接口：结合行运盘或太阳/月亮返照盘，生成月度运势分析，评估行星回归、逆行或重要相位（如土星与本命太阳的90度相位）对当月生活的影响，适合长期规划。
接口支持灵活的参数配置，如容许度设置、星盘样式选择和语言切换，输出结果包含运势评分、解读文本和星体数据，适用于占星类应用、网站或社交平台的运势功能开发。

应用场景： 占星类 APP：为用户提供个性化的九宫格星盘展示和每日/每周/每月运势推送。
社交媒体插件：集成到微信小程序或网页，生成趣味性的运势测试或星盘概览。
占星师工具：帮助专业占星师快速生成客户运势报告，提升分析效率。

单盘API接口文档 - 本命盘API、行运盘API、太阳返照盘API

接口说明

单盘接口用于生成基本的星盘图，包括本命盘、太阳返照盘等类型。此接口支持自定义宫位系统，并可选择是否使用中文字体。

基本信息

请求参数

请求示例

        {
        "chart_type": "natal",
        "data": {
        "datetime": "1990-01-01 12:00:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": "8.0"
        },
        "house_system": "P",
        "use_chinese_font": true
        }

返回参数

返回示例

        {
        "data": {
        "houses": {
            "1": 0.0,
            "2": 30.0,
            "3": 60.0,
            "4": 90.0,
            "5": 120.0,
            "6": 150.0,
            "7": 180.0,
            "8": 210.0,
            "9": 240.0,
            "10": 270.0,
            "11": 300.0,
            "12": 330.0
        },
        "planets": {
            "SUN": 280.5,
            "MOON": 120.3,
            "MERCURY": 295.8,
            "VENUS": 310.2,
            "MARS": 185.6,
            "JUPITER": 89.4,
            "SATURN": 275.9
        }
        },
        "svg": "..."
        }

测试代码示例

import requests
import json

class OnechartAPITest:
    def __init__(self, base_url="http://localhost:5000"):
        self.base_url = base_url
    
    def test_natal_chart(self):
        """测试本命盘API"""
        url = f"{self.base_url}/onechart"
        data = {
            "chart_type": "natal",
            "data": {
                "datetime": "1990-01-01 12:00:00",
                "lat": 39.9042,
                "lon": 116.4074,
                "tz": "8.0"
            },
            "house_system": "P",
            "use_chinese_font": True
        }
        
        try:
            response = requests.post(url, json=data)
            response.raise_for_status()
            result = response.json()
            
            print("本命盘API测试成功")
            print(f"返回数据包含: {list(result.keys())}")
            
            # 保存SVG文件
            if 'svg' in result and result['svg']:
                with open('natal_chart_test.svg', 'w', encoding='utf-8') as f:
                    f.write(result['svg'])
                print("SVG文件已保存为 natal_chart_test.svg")
            
            return result
            
        except requests.exceptions.RequestException as e:
            print(f"请求错误: {e}")
            return None
        except json.JSONDecodeError as e:
            print(f"JSON解析错误: {e}")
            return None
    
    def test_transit_chart(self):
        """测试行运盘API"""
        url = f"{self.base_url}/onechart"
        data = {
            "chart_type": "transit",
            "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:
            response = requests.post(url, json=data)
            response.raise_for_status()
            result = response.json()
            
            print("行运盘API测试成功")
            print(f"返回数据包含: {list(result.keys())}")
            
            # 保存SVG文件
            if 'svg' in result and result['svg']:
                with open('transit_chart_test.svg', 'w', encoding='utf-8') as f:
                    f.write(result['svg'])
                print("SVG文件已保存为 transit_chart_test.svg")
            
            return result
            
        except requests.exceptions.RequestException as e:
            print(f"请求错误: {e}")
            return None
        except json.JSONDecodeError as e:
            print(f"JSON解析错误: {e}")
            return None

# 使用示例
if __name__ == "__main__":
    tester = OnechartAPITest()
    
    print("=== 测试本命盘API ===")
    natal_result = tester.test_natal_chart()
    
    print("\n=== 测试行运盘API ===")
    transit_result = tester.test_transit_chart()

注意事项

• 日期时间格式必须严格遵循 YYYY-MM-DD HH:MM:SS 的格式
• 经纬度使用数字格式，东经北纬为正，西经南纬为负
• 时区使用字符串格式的数字，东区为正，西区为负，例如："8.0"、"-5.0"
• 宫位系统为可选参数，默认为"P"（普拉西德系统）
• 支持的chart_type包括："natal"（本命盘）、"transit"（行运盘）
• 返回的SVG字段可能为null，表示未生成图形
• API已通过完整测试，确保参数格式正确