古典尊贵API文档

接口说明

古典尊贵（Dignity）是中世纪占星术中评估行星力量的核心体系。本功能作为通用参数，可在所有星盘接口（单盘 /onechart、双盘 /bichart、三盘 /trichart）中通过 include_dignity 参数启用，返回每颗传统行星的先天尊贵与后天尊贵评分及详细分析。

核心概念

请求参数

在任意星盘接口的请求体中添加以下参数即可启用尊贵计算：

请求示例（单盘）

以本命盘为例，添加 include_dignity: true：

POST https://chart.12sign.top/onechart
Content-Type: application/json

{
  "chart_type": "natal",
  "data": {
    "datetime": "1990-06-15 14:30:00",
    "lon": 116.4,
    "lat": 39.9,
    "tz": "+8"
  },
  "include_dignity": true,
  "include_svg": false
}

双盘请求示例

双盘接口同样支持，尊贵数据将以 chart1_dignities 和 chart2_dignities 分别返回：

POST https://chart.12sign.top/bichart
Content-Type: application/json

{
  "chart_type": "synastry",
  "data1": { "datetime": "1990-06-15 14:30:00", "lon": 116.4, "lat": 39.9, "tz": "+8" },
  "data2": { "datetime": "1988-03-20 08:00:00", "lon": 121.5, "lat": 31.2, "tz": "+8" },
  "include_dignity": true,
  "include_svg": false
}

三盘请求示例

三盘接口中，尊贵数据以 chart1_dignities、chart2_dignities、chart3_dignities 分别返回。

返回结构

根据接口类型不同，尊贵数据的挂载位置有所区别：

尊贵数据字段说明

每个 dignities 对象包含 planets 数组和 summary 汇总：

行星尊贵对象（planets 数组中的每个元素）

先天尊贵（essential）

essential.details 中每项包含：

后天尊贵（accidental）

汇总（summary）

评分参考表

先天尊贵评分

后天尊贵评分

返回示例

以下为单盘本命盘的尊贵返回数据示例（以金星和太阳为例）：

{
  "dignities": {
    "planets": [
      {
        "name": "Venus",
        "name_cn": "金星",
        "longitude": 48.51,
        "sign": "Taurus",
        "sign_cn": "金牛座",
        "signlon": 18.51,
        "house": 7,
        "is_retrograde": false,
        "total": 25,
        "essential": {
          "score": 8,
          "dignities": ["ruler", "dayTrip"],
          "dignities_cn": ["庙", "日三分"],
          "details": {
            "ruler": { "name_cn": "庙", "score": 5, "active": true },
            "exalt": { "name_cn": "旺", "score": 4, "active": false, "ruler": "Moon" },
            "dayTrip": { "name_cn": "日三分", "score": 3, "active": true },
            "nightTrip": { "name_cn": "夜三分", "score": 3, "active": false, "ruler": "Moon" },
            "partTrip": { "name_cn": "参与三分", "score": 3, "active": false, "ruler": "Mars" },
            "term": { "name_cn": "界", "score": 2, "active": false, "ruler": "Jupiter" },
            "face": { "name_cn": "面", "score": 1, "active": false, "ruler": "Moon" },
            "mr_ruler": { "name_cn": "庙互容", "score": 5, "active": false },
            "mr_exalt": { "name_cn": "旺互容", "score": 4, "active": false },
            "exile": { "name_cn": "陷", "score": -5, "active": false, "ruler": "Mars" },
            "fall": { "name_cn": "弱", "score": -4, "active": false, "ruler": null }
          }
        },
        "accidental": {
          "score": 17,
          "details": {
            "house": 4,
            "no_under_sun": 5,
            "direction": 4,
            "joy_sign": 3,
            "speed": 2,
            "light": 1,
            "orientality": -2
          },
          "details_cn": {
            "house": { "name_cn": "宫位", "score": 4 },
            "no_under_sun": { "name_cn": "不在日光下", "score": 5 },
            "direction": { "name_cn": "顺逆行", "score": 4 },
            "joy_sign": { "name_cn": "星座喜悦", "score": 3 },
            "speed": { "name_cn": "速度", "score": 2 },
            "light": { "name_cn": "光线", "score": 1 },
            "orientality": { "name_cn": "东方性", "score": -2 }
          }
        }
      },
      {
        "name": "Sun",
        "name_cn": "太阳",
        "longitude": 84.17,
        "sign": "Gemini",
        "sign_cn": "双子座",
        "signlon": 24.17,
        "house": 9,
        "is_retrograde": false,
        "total": 6,
        "essential": {
          "score": 1,
          "dignities": ["face"],
          "dignities_cn": ["面"],
          "details": { "..." : "..." }
        },
        "accidental": {
          "score": 5,
          "details": { "..." : "..." },
          "details_cn": { "..." : "..." }
        }
      }
    ],
    "summary": {
      "strongest": { "name": "Venus", "name_cn": "金星", "total": 25, "..." : "..." },
      "weakest": { "name": "Sun", "name_cn": "太阳", "total": 6, "..." : "..." },
      "total_planets": 7
    }
  }
}

使用说明

Python测试代码

import requests
import json

def test_dignity():
    """测试本命盘的古典尊贵计算"""
    url = "https://chart.12sign.top/onechart"

    payload = {
        "chart_type": "natal",
        "data": {
            "datetime": "1990-06-15 14:30:00",
            "lon": 116.4,
            "lat": 39.9,
            "tz": "+8"
        },
        "include_dignity": True,
        "include_svg": False
    }

    response = requests.post(url, json=payload, timeout=30)
    data = response.json()

    if data.get("success"):
        dignities = data["data"]["dignities"]

        print("=== 行星尊贵排名 ===")
        for p in sorted(dignities["planets"], key=lambda x: x["total"], reverse=True):
            print(f"{p['name_cn']} ({p['sign_cn']}) 总分={p['total']} "
                  f"先天={p['essential']['score']} 后天={p['accidental']['score']}")
            if p['essential']['dignities_cn']:
                print(f"  先天尊贵: {', '.join(p['essential']['dignities_cn'])}")

        summary = dignities["summary"]
        print(f"\n最强: {summary['strongest']['name_cn']} (总分 {summary['strongest']['total']})")
        print(f"最弱: {summary['weakest']['name_cn']} (总分 {summary['weakest']['total']})")
    else:
        print(f"请求失败: {data.get('error')}")

if __name__ == "__main__":
    test_dignity()

在线测试

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