星盘报告接口

接口说明

星盘报告接口提供一套基于出生信息自动生成中文解读报告的 API。 用户只需传入出生时间、地点等信息，服务端结构化报告返回。

报告共 15 种，覆盖个人星盘、性格、爱情、南北交、宫主星、流年、运势、组合盘、朋友、业力等维度。 所有报告统一通过唯一入口 POST /report 提供，由请求参数 report_id 区分具体报告编号（01~15）。 不同报告所需的入参不同（单盘 / 双盘 / 运势），参数缺失或编号不支持时接口直接返回错误，调用方按每个 id 的请求要求传参即可。

通用说明

认证

提供 API 密钥认证。

请求数据格式

通过 data（双盘报告额外用 data2）传入出生信息，服务端自动计算星盘数据。

{
  "report_id": "01",
  "data": {
    "datetime": "1990-05-15 14:30:00",
    "lon": 116.4074,
    "lat": 39.9042,
    "tz": 8
  }
}

统一接口：POST /report

所有报告共用同一入口。通过 report_id 指定报告编号（只支持单个，不支持数组）， 传入出生信息即可获得报告，无需预先计算星盘。不同 id 的入参要求见下表的「所需请求参数」。

每个 report_id 所需的请求参数

请求示例

# 单盘报告（01 个人星盘）
{
  "report_id": "01",
  "data": {
    "datetime": "1990-05-15 14:30:00",
    "lon": 116.4074,
    "lat": 39.9042,
    "tz": 8
  }
}

# 双盘报告（03 爱情比较）
{
  "report_id": "03",
  "data":  { "datetime": "1990-05-15 14:30:00", "lon": 116.4074, "lat": 39.9042, "tz": 8 },
  "data2": { "datetime": "1992-08-20 09:15:00", "lon": 121.4737, "lat": 31.2304, "tz": 8 }
}

# 运势报告（10 月运）
{
  "report_id": "10",
  "data": { "datetime": "1990-05-15 14:30:00", "lon": 116.4074, "lat": 39.9042, "tz": 8 },
  "forecast_type": "monthly"
}

返回示例

{
  "success": true,
  "data": { "report_type": "natal_chart", "planets_in_signs": [...], "aspects": [...] }
}

错误返回示例

# 缺少必需参数
{ "success": false, "error": "报告 01 需要参数 data（出生信息）" }

# 双盘报告缺少第二人数据
{ "success": false, "error": "报告 03 需要两人的出生信息（data + data2）" }

# 出生信息字段缺失
{ "success": false, "error": "出生信息缺少必要字段: datetime, lon" }

# 编号不支持
{ "success": false, "error": "不支持的报告编号: 99，支持的编号: ['01','02',...,'15']" }

# forecast_type 非法
{ "success": false, "error": "无效的 forecast_type，支持: ['daily','weekly','monthly','yearly']" }

报告类型详解（15 种）

下表列出各报告编号、名称、请求所需的参数及报告内容说明。

Python 调用示例

import requests

BASE = "https://chart.12sign.top"

def get_report(report_id, data=None, data2=None,
               forecast_type="daily", house_system="P"):
    """
    统一报告调用：传入出生信息，服务端自动计算星盘。

    Args:
        report_id: 报告编号（01~15）
        data: 出生信息 dict，含 datetime/lon/lat/tz
        data2: 第二人出生信息（双盘报告 03/09/15 需要）
        forecast_type: 运势类型（仅报告 10），daily/weekly/monthly/yearly
        house_system: 宫位系统代码，默认 P（Placidus）
    """
    payload = {"report_id": report_id, "data": data}
    if data2 is not None:
        payload["data2"] = data2
    if forecast_type != "daily":
        payload["forecast_type"] = forecast_type
    if house_system != "P":
        payload["house_system"] = house_system
    r = requests.post(f"{BASE}/report", json=payload)
    return r.json()


if __name__ == "__main__":
    person1 = {
        "datetime": "1990-05-15 14:30:00",
        "lon": 116.4074,   # 北京经度
        "lat": 39.9042,    # 北京纬度
        "tz": 8            # UTC+8
    }
    person2 = {
        "datetime": "1992-08-20 09:15:00",
        "lon": 121.4737,   # 上海经度
        "lat": 31.2304,    # 上海纬度
        "tz": 8
    }

    # 单盘报告 01
    print(get_report("01", data=person1))

    # 双盘报告 03（爱情比较）
    print(get_report("03", data=person1, data2=person2))

    # 运势报告 10（月运）
    print(get_report("10", data=person1, forecast_type="monthly"))

    # 指定宫位系统（如 Koch）
    print(get_report("01", data=person1, house_system="K"))

在线测试

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