数据结构 - ApiWorks

数据结构总览

本API包含 212 个数据结构定义，分为请求对象、响应对象和其他数据模型三部分。

27

请求对象

105

响应对象

80

其他数据模型

请求对象

用于API请求的数据结构定义。

BaziFlowQry

八字流盘查询请求

字段定义

langstring

语言：zh-Hans（简体中文，默认）、zh-Hant（繁体中文）、en（English）

默认值: "zh-Hans"

birth_dtstring必填

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber | null

经度，可选

默认值: 116.39

latitudenumber | null

纬度，可选

默认值: 39.91

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

genderGenderType必填

生理性别：male(男)/female(女)。必填，用于确定阴阳属性（阳男/阴男/阳女/阴女）和大限顺逆方向

is_solar_timeboolean

是否使用真太阳时计算（默认false）

默认值: false

is_late_ziboolean

是否使用晚子时处理，23:00-00:00计算为本日（默认false，计算为次日）

默认值: false

ming_shen_gong_month_ruleMingShenGongMonthRule

命身宫月支起算：solar_term=节令月（与八字月柱月支一致，默认）；zhongqi=中气定月建（雨水起寅等）。

默认值: "solar_term"

target_dtstring | null

流盘参照时刻（可选），格式：'YYYY-MM-DD HH:mm:ss'。不传时默认「请求时区当天 12:00:00」。

示例数据

{
  "lang": "zh-Hans",
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 116.39,
  "latitude": 39.91,
  "dst_auto": true,
  "gender": "male",
  "is_solar_time": false,
  "is_late_zi": false,
  "ming_shen_gong_month_rule": "solar_term",
  "target_dt": "string"
}

BaziMatchQry

八字合盘查询请求

字段定义

langstring

语言：zh-Hans（简体中文，默认）、zh-Hant（繁体中文）、en（English）

默认值: "zh-Hans"

birth_dtstring必填

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber | null

经度，可选

默认值: 116.39

latitudenumber | null

纬度，可选

默认值: 39.91

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

genderGenderType必填

生理性别：male(男)/female(女)。必填，用于确定阴阳属性（阳男/阴男/阳女/阴女）和大限顺逆方向

is_solar_timeboolean

是否使用真太阳时计算（默认false）

默认值: false

is_late_ziboolean

是否使用晚子时处理，23:00-00:00计算为本日（默认false，计算为次日）

默认值: false

ming_shen_gong_month_ruleMingShenGongMonthRule

命身宫月支起算：solar_term=节令月（与八字月柱月支一致，默认）；zhongqi=中气定月建（雨水起寅等）。

默认值: "solar_term"

other_birth_dtstring必填

对方的出生日期时间，格式：'1999-10-17 21:00:00'

other_tzinteger

对方的时区，默认为8（中国时区）

默认值: 8

other_dst_autoboolean

对方是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

other_genderGenderType必填

生理性别：male(男)/female(女)。必填，用于确定阴阳属性（阳男/阴男/阳女/阴女）和大限顺逆方向

other_longitudenumber

对方的经度，默认为116.39

默认值: 116.39

other_latitudenumber

对方的纬度，默认为39.91

默认值: 39.91

示例数据

{
  "lang": "zh-Hans",
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 116.39,
  "latitude": 39.91,
  "dst_auto": true,
  "gender": "male",
  "is_solar_time": false,
  "is_late_zi": false,
  "ming_shen_gong_month_rule": "solar_term",
  "other_birth_dt": "1998-10-16 21:00:00",
  "other_tz": 8,
  "other_dst_auto": true,
  "other_gender": "male",
  "other_longitude": 116.39,
  "other_latitude": 39.91
}

BaziNatalQry

八字命盘查询请求

字段定义

langstring

语言：zh-Hans（简体中文，默认）、zh-Hant（繁体中文）、en（English）

默认值: "zh-Hans"

birth_dtstring必填

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber | null

经度，可选

默认值: 116.39

latitudenumber | null

纬度，可选

默认值: 39.91

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

genderGenderType必填

生理性别：male(男)/female(女)。必填，用于确定阴阳属性（阳男/阴男/阳女/阴女）和大限顺逆方向

is_solar_timeboolean

是否使用真太阳时计算（默认false）

默认值: false

is_late_ziboolean

是否使用晚子时处理，23:00-00:00计算为本日（默认false，计算为次日）

默认值: false

ming_shen_gong_month_ruleMingShenGongMonthRule

命身宫月支起算：solar_term=节令月（与八字月柱月支一致，默认）；zhongqi=中气定月建（雨水起寅等）。

默认值: "solar_term"

示例数据

{
  "lang": "zh-Hans",
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 116.39,
  "latitude": 39.91,
  "dst_auto": true,
  "gender": "male",
  "is_solar_time": false,
  "is_late_zi": false,
  "ming_shen_gong_month_rule": "solar_term"
}

CurrentEventQryReq

天象事件查询参数

字段定义

langstring

语言支持zh-Hant(繁体中文)、zh-Hans(简体中文)、en(English) 默认zh-Hans

默认值: "zh-Hans"

query_dtstring | null

查询日期时间，格式 1999-10-17 21:00:00，默认当天

示例数据

{
  "lang": "zh-Hans",
  "query_dt": "string"
}

DoublePointQry

两个时空点的查询参数（用于行运盘、日弧盘、组合盘、比较盘等）

字段定义

langstring

语言支持zh-Hant(繁体中文)、zh-Hans(简体中文)、en(English) 默认zh-Hans

默认值: "zh-Hans"

bodiesarray<string>

选定星体集合，值为星体编号

默认值: ["0","1","2","3","4","5","6","7","8","9","m"]

asteroidsarray<string>

小行星集合，值为星体编号

默认值: []

virtual_bodiesarray<string>

虚星集合，值为星体编号

默认值: ["11"]

zodiacAyType

黄道类型：Tropical(回归黄道)或Sidereal(恒星黄道)

默认值: "Tropical"

calc_methodChartFormatType

占星计算方法：Classical(古典盘)或Modern(现代盘)

默认值: "Modern"

house_systemHouseSystemType | null

宫位系统(未提供时：现代盘默认K，古典盘默认W)。可选值：P(Placidus), K(Koch), C(Campanus), R(Regiomontanus), U(Krusinski), E(Equal), V(Vehlow), W(Whole Signs), D(Equal/MC), N(Equal/Zodiac), O(Porphyry), B(Alcabitius), X(Meridian), F(Carter), M(Morinus), T(Polich/Page), H(Horizon), G(Gauquelin)

render_modeSvgType

星盘图格式：Default(默认盘),Pro(高级盘)或NoDisplay(不显示)

默认值: "Default"

include_corpusboolean

是否包含星盘语料，默认为 true

默认值: true

planet_orbsobject

行星容许度：dict[str,float]；键为星体编号，值为对应的容许度数值

默认值: {"0":1,"1":1,"2":0,"3":0,"4":0,"5":0,"6":0,"7":0,"8":0,"9":0,"10":0,"11":0,"m":0,"H":0}

aspect_orbsobject

相位容许度：键为相位度数字(如0/60/90/120/180)，值为对应的容许度数值

默认值: {"0":5,"60":5,"90":5,"120":5,"180":5}

user_listarray<TimeAndLocation>必填

两个人的出生时间地点信息，或者一个人出生和要推运的时间地点信息

示例数据

{
  "lang": "zh-Hans",
  "bodies": [
    "0",
    "1",
    "2",
    "3",
    "4",
    "5",
    "6",
    "7",
    "8",
    "9",
    "m"
  ],
  "asteroids": [],
  "virtual_bodies": [
    "11"
  ],
  "zodiac": "Tropical",
  "calc_method": "Modern",
  "house_system": "P",
  "render_mode": "Default",
  "include_corpus": true,
  "planet_orbs": {
    "0": 1,
    "1": 1,
    "2": 0,
    "3": 0,
    "4": 0,
    "5": 0,
    "6": 0,
    "7": 0,
    "8": 0,
    "9": 0,
    "10": 0,
    "11": 0,
    "m": 0,
    "H": 0
  },
  "aspect_orbs": {
    "0": 5,
    "60": 5,
    "90": 5,
    "120": 5,
    "180": 5
  },
  "user_list": [
    {
      "birth_dt": "1999-10-17 21:00:00",
      "latitude": 39.9042,
      "longitude": 116.4074,
      "tz": 8
    },
    {
      "birth_dt": "2001-10-17 21:00:00",
      "latitude": 39.9042,
      "longitude": 116.4074,
      "tz": 8
    }
  ]
}

DpTransitDateQry

带推运日期的查询参数

字段定义

langstring

语言支持zh-Hant(繁体中文)、zh-Hans(简体中文)、en(English) 默认zh-Hans

默认值: "zh-Hans"

bodiesarray<string>

选定星体集合，值为星体编号

默认值: ["0","1","2","3","4","5","6","7","8","9","m"]

asteroidsarray<string>

小行星集合，值为星体编号

默认值: []

virtual_bodiesarray<string>

虚星集合，值为星体编号

默认值: ["11"]

zodiacAyType

黄道类型：Tropical(回归黄道)或Sidereal(恒星黄道)

默认值: "Tropical"

calc_methodChartFormatType

占星计算方法：Classical(古典盘)或Modern(现代盘)

默认值: "Modern"

house_systemHouseSystemType | null

render_modeSvgType

星盘图格式：Default(默认盘),Pro(高级盘)或NoDisplay(不显示)

默认值: "Default"

include_corpusboolean

是否包含星盘语料，默认为 true

默认值: true

planet_orbsobject

行星容许度：dict[str,float]；键为星体编号，值为对应的容许度数值

默认值: {"0":1,"1":1,"2":0,"3":0,"4":0,"5":0,"6":0,"7":0,"8":0,"9":0,"10":0,"11":0,"m":0,"H":0}

aspect_orbsobject

相位容许度：键为相位度数字(如0/60/90/120/180)，值为对应的容许度数值

默认值: {"0":5,"60":5,"90":5,"120":5,"180":5}

user_listarray<TimeAndLocation>必填

两个人的出生时间地点信息，或者一个人出生和要推运的时间地点信息

transit_dtstring必填

查询时间时间格式1999-10-17 21:00:00

示例数据

{
  "lang": "zh-Hans",
  "bodies": [
    "0",
    "1",
    "2",
    "3",
    "4",
    "5",
    "6",
    "7",
    "8",
    "9",
    "m"
  ],
  "asteroids": [],
  "virtual_bodies": [
    "11"
  ],
  "zodiac": "Tropical",
  "calc_method": "Modern",
  "house_system": "P",
  "render_mode": "Default",
  "include_corpus": true,
  "planet_orbs": {
    "0": 1,
    "1": 1,
    "2": 0,
    "3": 0,
    "4": 0,
    "5": 0,
    "6": 0,
    "7": 0,
    "8": 0,
    "9": 0,
    "10": 0,
    "11": 0,
    "m": 0,
    "H": 0
  },
  "aspect_orbs": {
    "0": 5,
    "60": 5,
    "90": 5,
    "120": 5,
    "180": 5
  },
  "user_list": [
    {
      "birth_dt": "1999-10-17 21:00:00",
      "latitude": 39.9042,
      "longitude": 116.4074,
      "tz": 8
    },
    {
      "birth_dt": "2001-10-17 21:00:00",
      "latitude": 39.9042,
      "longitude": 116.4074,
      "tz": 8
    }
  ],
  "transit_dt": "2025-10-17 21:00:00"
}

LiurenQry

大六壬排盘请求参数（标准金口诀/大六壬通用）

时柱由 qry_dt（及真太阳时等）自动推算。

字段定义

langstring

语言：zh-Hans（简体中文，默认）、zh-Hant（繁体中文）；后续可扩展 en 等

默认值: "zh-Hans"

qry_dtstring | null

查询时间，格式为1999-10-17 21:00:00

tzinteger | null

时区，默认东八区

默认值: 8

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

longitudenumber | null

经度，用于真太阳时，范围 [-180, 180]

默认值: 120

latitudenumber | null

纬度，用于真太阳时，范围 [-90, 90]

is_solar_timeboolean

是否使用真太阳时计算（默认false）

默认值: false

typeLiurenPanType

daliuren=大六壬（默认） | jinkoujue=金口诀

默认值: "daliuren"

di_fenLiurenDiFen | null

金口诀专用：地分（十二地支）；大六壬可忽略

gui_methodLiurenGuiRenMethod

贵人起法：tian=天贵（默认） | di=地贵

默认值: "tian"

lucky_numberinteger | null

报数起课：用户随机数字，按 (n-1)%12 定占时（1→子时，2→丑时…12→亥时，13→子时循环）；为空则按 qry_dt 实际时辰起课

示例数据

{
  "lang": "zh-Hans",
  "qry_dt": "string",
  "tz": 8,
  "dst_auto": true,
  "longitude": 120,
  "latitude": 0,
  "is_solar_time": false,
  "type": "daliuren",
  "di_fen": "zi",
  "gui_method": "tian",
  "lucky_number": 1
}

MoodQryReq

每日心情查询参数
提供出生时间地点和查询时间

字段定义

langstring

语言支持zh-Hant(繁体中文)、zh-Hans(简体中文)、en(English) 默认zh-Hans

默认值: "zh-Hans"

birth_pointTimeAndLocation必填

出生时空点信息

transit_dtstring | null

日期时间字符串（查询时间, 默认为当天），格式为1999-10-17 21:00:00

示例数据

{
  "lang": "zh-Hans",
  "birth_point": {
    "birth_dt": "1999-10-17 21:00:00",
    "tz": 8,
    "longitude": 116.4074,
    "latitude": 39.9042,
    "dst_auto": true
  },
  "transit_dt": "string"
}

NaksQry

星宿关系查询请求

字段定义

langstring

语言：zh-Hans（简体中文，默认）、zh-Hant（繁体中文）；后续可扩展 en 等

默认值: "zh-Hans"

birth_infoBirthInfo必填

用户出生信息

others_birth_infoarray<BirthInfo>

其他人的出生信息列表

默认值: []

is_solar_timeboolean

是否使用真太阳时计算（默认false）

默认值: false

is_late_ziboolean

是否使用晚子时处理，23:00-00:00计算为本日（默认false，计算为次日）

默认值: false

niu_xiu_handleNiuXiuHandleType

牛宿处理类型, nvxiu(女宿)/douxiu(斗宿)，默认nvxiu

默认值: "nvxiu"

示例数据

{
  "lang": "zh-Hans",
  "birth_info": {
    "birth_dt": "1999-10-17 21:00:00",
    "tz": 8,
    "longitude": 0,
    "latitude": 0,
    "dst_auto": true,
    "user_id": ""
  },
  "others_birth_info": [],
  "is_solar_time": false,
  "is_late_zi": false,
  "niu_xiu_handle": "nvxiu"
}

QimenQry

奇门遁甲请求参数

时柱由 qry_dt（及真太阳时等）自动推算。
日家（type=rijia）：

ju_method=jinhan（默认）：金函玉镜 / 太乙日家，太乙九星 + 休门三日法，不定三元局。
ju_method=traditional：传统日家，二至邻甲子 + 60 日断代（174/936）+ 日干支枢轴排盘（九星八门八神）。

字段定义

langstring

语言：zh-Hans（简体中文，默认）、zh-Hant（繁体中文）；后续可扩展 en 等

默认值: "zh-Hans"

qry_dtstring | null

查询时间，格式为1999-10-17 21:00:00

tzinteger | null

时区，默认东八区

默认值: 8

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

longitudenumber | null

经度，用于真太阳时，范围 [-180, 180]

默认值: 120

latitudenumber | null

纬度，用于真太阳时，范围 [-90, 90]

is_solar_timeboolean

是否使用真太阳时计算（默认false）

默认值: false

typeQimenQijuType

起局类型：shijia=时家(默认) | rijia=日家（ju_method 默认 jinhan=金函玉镜；traditional=传统日盘） | shanxiang=山向

默认值: "shijia"

pai_methodQimenPaiPanMethod

排盘方式：zhuanpan=转盘 | feipan=飞盘（子流派见 feipan_style）

默认值: "zhuanpan"

feipan_styleQimenFeipanStyle

飞盘子流派（仅 pai_method=feipan 时生效，默认 zhigui）：zhigui=旨归 | yinpan=阴盘 | faqiao=法窍 | mingfa=鸣法 | kuonang=括囊

默认值: "zhigui"

ju_methodQimenDingJuMethod | null

定局方法，随起局 type 限制取值：日家 jinhan（金函玉镜，默认）或 traditional（传统日盘）；时家 chaibu、zhirun、maoshan、yinpan；山向固定 not_applicable。省略 ju_method 时按 type 自动默认。

with_liurenboolean | null

奇门穿壬（含六壬），默认false

默认值: false

shanQimenShanBranch | null

（兼容）坐山十二地支拼音，如 zi；优先使用 shan_mount

shan_mountQimenMount24 | null

坐山二十四山英文 code：ren、zi、gui、gen…

yuanQimenYuanSegment | null

三元分金：shang=上元 | zhong=中元 | xia=下元；省略时默认 shang

tianqin_jiQimenTianqinJiGong | null

天禽寄宫（仅山向+转盘生效，默认寄坤二）：kun2 | gen8 | seasonal（阳遁寄艮八、阴遁寄坤二）

示例数据

{
  "lang": "zh-Hans",
  "qry_dt": "string",
  "tz": 8,
  "dst_auto": true,
  "longitude": 120,
  "latitude": 0,
  "is_solar_time": false,
  "type": "shijia",
  "pai_method": "zhuanpan",
  "feipan_style": "zhigui",
  "ju_method": "chaibu",
  "with_liuren": false,
  "shan": "zi",
  "shan_mount": "ren",
  "yuan": "shang",
  "tianqin_ji": "kun2"
}

QimenSelectQry

奇门择吉请求参数：days 天内（默认 7，范围 1~10）每 2 小时一时辰，共 days×12 个时辰逐时起局评分。

排盘参数（pai_method/feipan_style/ju_method）复用时家语义，ju_method 限时家集合，默认 chaibu。

字段定义

langstring

语言：zh-Hans（简体中文，默认）、zh-Hant（繁体中文）；后续可扩展 en 等

默认值: "zh-Hans"

qry_dtstring | null

查询时间，格式为1999-10-17 21:00:00

tzinteger | null

时区，默认东八区

默认值: 8

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

longitudenumber | null

经度，用于真太阳时，范围 [-180, 180]

默认值: 120

latitudenumber | null

纬度，用于真太阳时，范围 [-90, 90]

is_solar_timeboolean

是否使用真太阳时计算（默认false）

默认值: false

daysinteger

评分天数（1~10，默认 7）：每 2 小时一时辰，共 days×12 个时辰

默认值: 7

matterQimenMatter | null

用事（12 种）：travel=出行 wealth=求财 plan=谋事 opening=开业 marriage=嫁娶 exam=考试 medical=求医 lawsuit=诉讼 moving=搬家 offspring=求嗣 trade=交易 meeting=会友；不传则不做用事加权

include_directionsboolean

是否返回每时辰九宫方位全明细（默认 false，避免 payload 过大）

默认值: false

pai_methodQimenPaiPanMethod

排盘方式：zhuanpan=转盘 | feipan=飞盘（子流派见 feipan_style）

默认值: "zhuanpan"

feipan_styleQimenFeipanStyle

飞盘子流派（仅 pai_method=feipan 时生效，默认 zhigui）

默认值: "zhigui"

ju_methodQimenDingJuMethod | null

定局方法（时家）：chaibu（默认）、zhirun、maoshan、yinpan

示例数据

{
  "lang": "zh-Hans",
  "qry_dt": "string",
  "tz": 8,
  "dst_auto": true,
  "longitude": 120,
  "latitude": 0,
  "is_solar_time": false,
  "days": 7,
  "matter": "travel",
  "include_directions": false,
  "pai_method": "zhuanpan",
  "feipan_style": "zhigui",
  "ju_method": "chaibu"
}

QizhengComparisonQry

七政四余比较盘（对齐 Moira COMPARISON_MODE 双环）。

user_list[0] = A（内盘本命：十二宫/命度/宿尺）；
user_list[1] = B（外盘本命星，按黄经叠入 A 宫位）。

字段定义

langstring

语言：zh-Hans（简体中文，默认）、zh-Hant（繁体中文）、en（English）

默认值: "zh-Hans"

user_listarray<QizhengPersonQry>必填

两人生辰，长度必须为 2：[0]=A 本命基座，[1]=B 叠入

zodiacQizhengZodiac

黄道：tropical（回归，默认）/ sidereal（恒星，暂仍按回归）

默认值: "tropical"

xiu_rulerQizhengXiuRuler

二十八宿尺：modern（默认，随 A 本命时刻）/ ancient

默认值: "modern"

示例数据

{
  "lang": "zh-Hans",
  "user_list": [
    {
      "birth_dt": "1973-09-05 05:48:31",
      "gender": "male",
      "latitude": 39.91,
      "longitude": 116.39,
      "tz": 8
    },
    {
      "birth_dt": "2000-06-15 12:00:00",
      "gender": "female",
      "latitude": 39.91,
      "longitude": 116.39,
      "tz": 8
    }
  ],
  "zodiac": "tropical",
  "xiu_ruler": "modern"
}

QizhengNatalQry

七政四余本命盘请求。

本命只依赖出生信息，不需要 target_dt。
经纬度缺省为北京，与 ziwei/bazi 一致；开真太阳时时经度必填。

字段定义

langstring

语言：zh-Hans（简体中文，默认）、zh-Hant（繁体中文）、en（English）

默认值: "zh-Hans"

birth_dtstring必填

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber | null

经度，可选，默认北京

默认值: 116.39

latitudenumber | null

纬度，可选，默认北京

默认值: 39.91

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

genderGenderType必填

生理性别：male(男)/female(女)。诸限童限等实现时按性别取用

is_solar_timeboolean

是否使用真太阳时计算（默认 false）

默认值: false

is_late_ziboolean

是否使用晚子时：23:00-00:00 计为本日（默认 false，计为次日）

默认值: false

zodiacQizhengZodiac

黄道：tropical（回归，默认）/ sidereal（恒星）。当前计算只走回归；传入 sidereal 仍按回归排，直到恒星分支实现。

默认值: "tropical"

xiu_rulerQizhengXiuRuler

二十八宿尺：modern（今宿=Moira 距星，随本命时刻，默认） / ancient（古宿量天尺）。

默认值: "modern"

示例数据

{
  "lang": "zh-Hans",
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 116.39,
  "latitude": 39.91,
  "dst_auto": true,
  "gender": "male",
  "is_solar_time": false,
  "is_late_zi": false,
  "zodiac": "tropical",
  "xiu_ruler": "modern"
}

QizhengPersonQry

比较盘一方生辰（不含黄道/宿尺/lang，由外层共享）。

字段定义

birth_dtstring必填

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber | null

经度，可选，默认北京

默认值: 116.39

latitudenumber | null

纬度，可选，默认北京

默认值: 39.91

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

genderGenderType必填

生理性别：male(男)/female(女)

is_solar_timeboolean

是否使用真太阳时计算（默认 false）

默认值: false

is_late_ziboolean

是否使用晚子时：23:00-00:00 计为本日（默认 false，计为次日）

默认值: false

示例数据

{
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 116.39,
  "latitude": 39.91,
  "dst_auto": true,
  "gender": "male",
  "is_solar_time": false,
  "is_late_zi": false
}

QizhengQry

七政四余排盘请求（本命 + 行运）。

target_dt 用于流十一曜与当前诸限；不传则按请求时区「当天 12:00:00」，与八字流盘一致。

字段定义

langstring

语言：zh-Hans（简体中文，默认）、zh-Hant（繁体中文）、en（English）

默认值: "zh-Hans"

birth_dtstring必填

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber | null

经度，可选，默认北京

默认值: 116.39

latitudenumber | null

纬度，可选，默认北京

默认值: 39.91

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

genderGenderType必填

生理性别：male(男)/female(女)。诸限童限等实现时按性别取用

is_solar_timeboolean

是否使用真太阳时计算（默认 false）

默认值: false

is_late_ziboolean

是否使用晚子时：23:00-00:00 计为本日（默认 false，计为次日）

默认值: false

zodiacQizhengZodiac

黄道：tropical（回归，默认）/ sidereal（恒星）。当前计算只走回归；传入 sidereal 仍按回归排，直到恒星分支实现。

默认值: "tropical"

xiu_rulerQizhengXiuRuler

二十八宿尺：modern（今宿=Moira 距星，随本命时刻，默认） / ancient（古宿量天尺）。

默认值: "modern"

target_dtstring | null

行运参照时刻（可选），格式：'YYYY-MM-DD HH:mm:ss'。不传时默认「请求时区当天 12:00:00」。

示例数据

{
  "lang": "zh-Hans",
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 116.39,
  "latitude": 39.91,
  "dst_auto": true,
  "gender": "male",
  "is_solar_time": false,
  "is_late_zi": false,
  "zodiac": "tropical",
  "xiu_ruler": "modern",
  "target_dt": "string"
}

RomanticCreateQry

桃花报告请求参数
提供用户的出生及当前时空点信息

字段定义

user_birth_pointTimeAndLocation必填

用户的出生时空点信息

user_current_pointTimeAndLocation必填

用户当前的时空点信息

user_idstring必填

用户ID, 用于防止重复创建

示例数据

{
  "user_birth_point": {
    "birth_dt": "1999-10-17 21:00:00",
    "tz": 8,
    "longitude": 116.4074,
    "latitude": 39.9042,
    "dst_auto": true
  },
  "user_current_point": {
    "birth_dt": "1999-10-17 21:00:00",
    "tz": 8,
    "longitude": 116.4074,
    "latitude": 39.9042,
    "dst_auto": true
  },
  "user_id": "12345"
}

ScopeQryReq

运势查询参数
提供出生时空点和推运时空点

字段定义

langstring

语言支持zh-Hant(繁体中文)、zh-Hans(简体中文)、en(English) 默认zh-Hans

默认值: "zh-Hans"

birth_pointTimeAndLocation必填

出生时空点信息

transit_pointTimeAndLocation必填

推运时空点信息

示例数据

{
  "lang": "zh-Hans",
  "birth_point": {
    "birth_dt": "1999-10-17 21:00:00",
    "tz": 8,
    "longitude": 116.4074,
    "latitude": 39.9042,
    "dst_auto": true
  },
  "transit_point": {
    "birth_dt": "1999-10-17 21:00:00",
    "tz": 8,
    "longitude": 116.4074,
    "latitude": 39.9042,
    "dst_auto": true
  }
}

SignQry

星座查询参数

字段定义

birth_dtstring必填

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber必填

经度

latitudenumber必填

纬度

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

langstring

语言支持zh-Hant(繁体中文)、zh-Hans(简体中文)、en(English) 默认zh-Hans

默认值: "zh-Hans"

示例数据

{
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 116.4074,
  "latitude": 39.9042,
  "dst_auto": true,
  "lang": "zh-Hans"
}

SinglePointQry

单时空点查询参数

字段定义

langstring

语言支持zh-Hant(繁体中文)、zh-Hans(简体中文)、en(English) 默认zh-Hans

默认值: "zh-Hans"

bodiesarray<string>

选定星体集合，值为星体编号

默认值: ["0","1","2","3","4","5","6","7","8","9","m"]

asteroidsarray<string>

小行星集合，值为星体编号

默认值: []

virtual_bodiesarray<string>

虚星集合，值为星体编号

默认值: ["11"]

zodiacAyType

黄道类型：Tropical(回归黄道)或Sidereal(恒星黄道)

默认值: "Tropical"

calc_methodChartFormatType

占星计算方法：Classical(古典盘)或Modern(现代盘)

默认值: "Modern"

house_systemHouseSystemType | null

render_modeSvgType

星盘图格式：Default(默认盘),Pro(高级盘)或NoDisplay(不显示)

默认值: "Default"

include_corpusboolean

是否包含星盘语料，默认为 true

默认值: true

planet_orbsobject

行星容许度：dict[str,float]；键为星体编号，值为对应的容许度数值

默认值: {"0":1,"1":1,"2":0,"3":0,"4":0,"5":0,"6":0,"7":0,"8":0,"9":0,"10":0,"11":0,"m":0,"H":0}

aspect_orbsobject

相位容许度：键为相位度数字(如0/60/90/120/180)，值为对应的容许度数值

默认值: {"0":5,"60":5,"90":5,"120":5,"180":5}

birth_dtstring必填

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber必填

经度

latitudenumber必填

纬度

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

示例数据

{
  "lang": "zh-Hans",
  "bodies": [
    "0",
    "1",
    "2",
    "3",
    "4",
    "5",
    "6",
    "7",
    "8",
    "9",
    "m"
  ],
  "asteroids": [],
  "virtual_bodies": [
    "11"
  ],
  "zodiac": "Tropical",
  "calc_method": "Modern",
  "house_system": "P",
  "render_mode": "Default",
  "include_corpus": true,
  "planet_orbs": {
    "0": 1,
    "1": 1,
    "2": 0,
    "3": 0,
    "4": 0,
    "5": 0,
    "6": 0,
    "7": 0,
    "8": 0,
    "9": 0,
    "10": 0,
    "11": 0,
    "m": 0,
    "H": 0
  },
  "aspect_orbs": {
    "0": 5,
    "60": 5,
    "90": 5,
    "120": 5,
    "180": 5
  },
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 116.4074,
  "latitude": 39.9042,
  "dst_auto": true
}

SpTransitDateQry

带推运日期的查询参数

字段定义

langstring

语言支持zh-Hant(繁体中文)、zh-Hans(简体中文)、en(English) 默认zh-Hans

默认值: "zh-Hans"

bodiesarray<string>

选定星体集合，值为星体编号

默认值: ["0","1","2","3","4","5","6","7","8","9","m"]

asteroidsarray<string>

小行星集合，值为星体编号

默认值: []

virtual_bodiesarray<string>

虚星集合，值为星体编号

默认值: ["11"]

zodiacAyType

黄道类型：Tropical(回归黄道)或Sidereal(恒星黄道)

默认值: "Tropical"

calc_methodChartFormatType

占星计算方法：Classical(古典盘)或Modern(现代盘)

默认值: "Modern"

house_systemHouseSystemType | null

render_modeSvgType

星盘图格式：Default(默认盘),Pro(高级盘)或NoDisplay(不显示)

默认值: "Default"

include_corpusboolean

是否包含星盘语料，默认为 true

默认值: true

planet_orbsobject

行星容许度：dict[str,float]；键为星体编号，值为对应的容许度数值

默认值: {"0":1,"1":1,"2":0,"3":0,"4":0,"5":0,"6":0,"7":0,"8":0,"9":0,"10":0,"11":0,"m":0,"H":0}

aspect_orbsobject

相位容许度：键为相位度数字(如0/60/90/120/180)，值为对应的容许度数值

默认值: {"0":5,"60":5,"90":5,"120":5,"180":5}

birth_dtstring必填

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber必填

经度

latitudenumber必填

纬度

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

transit_dtstring必填

查询时间时间格式1999-10-17 21:00:00

示例数据

{
  "lang": "zh-Hans",
  "bodies": [
    "0",
    "1",
    "2",
    "3",
    "4",
    "5",
    "6",
    "7",
    "8",
    "9",
    "m"
  ],
  "asteroids": [],
  "virtual_bodies": [
    "11"
  ],
  "zodiac": "Tropical",
  "calc_method": "Modern",
  "house_system": "P",
  "render_mode": "Default",
  "include_corpus": true,
  "planet_orbs": {
    "0": 1,
    "1": 1,
    "2": 0,
    "3": 0,
    "4": 0,
    "5": 0,
    "6": 0,
    "7": 0,
    "8": 0,
    "9": 0,
    "10": 0,
    "11": 0,
    "m": 0,
    "H": 0
  },
  "aspect_orbs": {
    "0": 5,
    "60": 5,
    "90": 5,
    "120": 5,
    "180": 5
  },
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 116.4074,
  "latitude": 39.9042,
  "dst_auto": true,
  "transit_dt": "2026-10-17 21:00:00"
}

TogetherCreateQry

合盘报告请求参数
用户及对方的出生时空点信息

字段定义

user_birth_pointTimeAndLocation必填

用户的出生时空点信息

other_birth_pointTimeAndLocation必填

对方的出生时空点信息

user_idstring必填

用户ID, 用于防止重复创建

示例数据

{
  "user_birth_point": {
    "birth_dt": "1999-10-17 21:00:00",
    "tz": 8,
    "longitude": 116.4074,
    "latitude": 39.9042,
    "dst_auto": true
  },
  "other_birth_point": {
    "birth_dt": "1999-10-17 21:00:00",
    "tz": 8,
    "longitude": 116.4074,
    "latitude": 39.9042,
    "dst_auto": true
  },
  "user_id": "12345"
}

WealthCreateQry

财运报告请求参数
单时空点查询参数

字段定义

user_birth_pointTimeAndLocation必填

用户的出生时空点信息

user_idstring必填

用户ID, 用于防止重复创建

示例数据

{
  "user_birth_point": {
    "birth_dt": "1999-10-17 21:00:00",
    "tz": 8,
    "longitude": 116.4074,
    "latitude": 39.9042,
    "dst_auto": true
  },
  "user_id": "12345"
}

WeeklyScopeCreateQry

周运势报告请求参数
带推运日期的查询参数

字段定义

user_birth_pointTimeAndLocation必填

用户的出生时空点信息

transit_dtstring必填

查询时间时间格式1999-10-17 21:00:00

user_idstring必填

用户ID, 用于防止重复创建

示例数据

{
  "user_birth_point": {
    "birth_dt": "1999-10-17 21:00:00",
    "tz": 8,
    "longitude": 116.4074,
    "latitude": 39.9042,
    "dst_auto": true
  },
  "transit_dt": "2026-01-01 01:02:03",
  "user_id": "12345"
}

YearlyScopeCreateQry

年运势报告请求参数
带推运日期的查询参数

字段定义

user_birth_pointTimeAndLocation必填

用户的出生时空点信息

transit_dtstring必填

查询时间时间格式1999-10-17 21:00:00

user_idstring必填

用户ID, 用于防止重复创建

示例数据

{
  "user_birth_point": {
    "birth_dt": "1999-10-17 21:00:00",
    "tz": 8,
    "longitude": 116.4074,
    "latitude": 39.9042,
    "dst_auto": true
  },
  "transit_dt": "2026-01-01 01:02:03",
  "user_id": "12345"
}

ZiweiMatchQry

紫微合盘查询参数（生年干互飞：四化 + 禄存/擎羊/陀罗）

本人字段复用 ZiweiNatalQry；对方出生信息用 other_* 字段。
is_solar_time / is_late_zi / leap_boundary / custom_transforms 双方共用。

字段定义

langstring

语言：zh-Hans（简体中文，默认）、zh-Hant（繁体中文）、en（English）

默认值: "zh-Hans"

birth_dtstring必填

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber | null

经度，可选

默认值: 116.39

latitudenumber | null

纬度，可选

默认值: 39.91

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

genderGenderType必填

生理性别：male(男)/female(女)。必填，用于确定阴阳属性（阳男/阴男/阳女/阴女）和大限顺逆方向

custom_transformsobject | null

自定义四化配置，key 为天干（推荐 stem key：jia、wu、geng、xin、ren、gui；亦兼容旧接口中文：甲、戊、庚、辛、壬、癸），value 为四化配置类型枚举

is_solar_timeboolean

是否使用真太阳时计算（默认false）

默认值: false

is_late_ziboolean

是否使用晚子时处理，23:00-00:00计算为本日（默认false，计算为次日）

默认值: false

leap_boundaryLeapBoundaryType | null

闰月分界：mid_month(月中分隔)/current_month(隶属本月)/next_month(隶属下月)，默认mid_month

默认值: "mid_month"

other_birth_dtstring必填

对方出生日期时间，格式：'1999-10-17 21:00:00'

other_tzinteger

对方时区，默认为 8

默认值: 8

other_dst_autoboolean

对方是否自动夏令时校正（仅对中国大陆地区有效）

默认值: true

other_genderGenderType必填

对方生理性别：male(男)/female(女)

other_longitudenumber | null

对方经度，可选

默认值: 116.39

other_latitudenumber | null

对方纬度，可选

默认值: 39.91

示例数据

{
  "lang": "zh-Hans",
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 116.39,
  "latitude": 39.91,
  "dst_auto": true,
  "gender": "male",
  "custom_transforms": {},
  "is_solar_time": false,
  "is_late_zi": false,
  "leap_boundary": "mid_month",
  "other_birth_dt": "1999-11-02 12:00:00",
  "other_tz": 8,
  "other_dst_auto": true,
  "other_gender": "male",
  "other_longitude": 116.39,
  "other_latitude": 39.91
}

ZiweiNatalQry

紫微斗数本命盘查询参数

本命盘只依赖于固定的出生信息，不需要目标日期

字段定义

langstring

语言：zh-Hans（简体中文，默认）、zh-Hant（繁体中文）、en（English）

默认值: "zh-Hans"

birth_dtstring必填

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber | null

经度，可选

默认值: 116.39

latitudenumber | null

纬度，可选

默认值: 39.91

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

genderGenderType必填

生理性别：male(男)/female(女)。必填，用于确定阴阳属性（阳男/阴男/阳女/阴女）和大限顺逆方向

custom_transformsobject | null

自定义四化配置，key 为天干（推荐 stem key：jia、wu、geng、xin、ren、gui；亦兼容旧接口中文：甲、戊、庚、辛、壬、癸），value 为四化配置类型枚举

is_solar_timeboolean

是否使用真太阳时计算（默认false）

默认值: false

is_late_ziboolean

是否使用晚子时处理，23:00-00:00计算为本日（默认false，计算为次日）

默认值: false

leap_boundaryLeapBoundaryType | null

闰月分界：mid_month(月中分隔)/current_month(隶属本月)/next_month(隶属下月)，默认mid_month

默认值: "mid_month"

示例数据

{
  "lang": "zh-Hans",
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 116.39,
  "latitude": 39.91,
  "dst_auto": true,
  "gender": "male",
  "custom_transforms": {},
  "is_solar_time": false,
  "is_late_zi": false,
  "leap_boundary": "mid_month"
}

ZiweiQry

紫微斗数查询参数（包含运限数据）

继承自 ZiweiNatalQry，增加了 target_dt 字段用于计算运限数据

字段定义

langstring

语言：zh-Hans（简体中文，默认）、zh-Hant（繁体中文）、en（English）

默认值: "zh-Hans"

birth_dtstring必填

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber | null

经度，可选

默认值: 116.39

latitudenumber | null

纬度，可选

默认值: 39.91

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

genderGenderType必填

生理性别：male(男)/female(女)。必填，用于确定阴阳属性（阳男/阴男/阳女/阴女）和大限顺逆方向

custom_transformsobject | null

自定义四化配置，key 为天干（推荐 stem key：jia、wu、geng、xin、ren、gui；亦兼容旧接口中文：甲、戊、庚、辛、壬、癸），value 为四化配置类型枚举

is_solar_timeboolean

是否使用真太阳时计算（默认false）

默认值: false

is_late_ziboolean

是否使用晚子时处理，23:00-00:00计算为本日（默认false，计算为次日）

默认值: false

leap_boundaryLeapBoundaryType | null

闰月分界：mid_month(月中分隔)/current_month(隶属本月)/next_month(隶属下月)，默认mid_month

默认值: "mid_month"

target_dtstring | null

目标日期时间（可选），格式：'1999-10-17 21:00:00'，如果不提供则使用当前时间。用于计算运限数据（大限、流年、流月、流日、流时）

示例数据

{
  "lang": "zh-Hans",
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 116.39,
  "latitude": 39.91,
  "dst_auto": true,
  "gender": "male",
  "custom_transforms": {},
  "is_solar_time": false,
  "is_late_zi": false,
  "leap_boundary": "mid_month",
  "target_dt": "string"
}

响应对象

API响应的数据结构定义。

ApiResp

object

封装API响应的类

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataunknown | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": null,
  "exe_time": 0
}

ApiResp[AstroDataVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataAstroDataVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "sign": [
      {
        "sign_id": 0,
        "sign_en": "string",
        "sign_cn": "string",
        "sign_name": "示例名称",
        "sign_font": "string",
        "sign_attribute": [
          "string"
        ],
        "sign_guardian": [
          {
            "planet_code": "string",
            "planet_en": "string",
            "planet_cn": "string",
            "planet_name": "示例名称",
            "planet_font": "string"
          }
        ],
        "planet_array": [
          {
            "planet_code": "string",
            "planet_en": "string",
            "planet_cn": "string",
            "planet_name": "示例名称",
            "longitude": 0,
            "house_id": 0,
            "speed": 0,
            "planet_font": "string",
            "deg": 0,
            "min": 0,
            "sec": 0
          }
        ]
      }
    ],
    "planet": [
      {
        "sign": {
          "deg": 0,
          "min": 0,
          "sec": 0,
          "sign_id": 0,
          "sign_en": "string",
          "sign_cn": "string",
          "sign_name": "示例名称",
          "sign_font": "string"
        },
        "planet_en": "string",
        "planet_cn": "string",
        "planet_name": "示例名称",
        "planet_code": "string",
        "longitude": 0,
        "house_id": 0,
        "speed": 0,
        "planet_font": "string",
        "house_longitude": 0,
        "house_deg": 0,
        "house_min": 0,
        "house_sec": 0
      }
    ],
    "house": [
      {
        "sign": {
          "deg": 0,
          "min": 0,
          "sec": 0,
          "sign_id": 0,
          "sign_en": "string",
          "sign_cn": "string",
          "sign_name": "示例名称",
          "sign_font": "string"
        },
        "longitude": 0,
        "house_id": 0,
        "house_life": "string",
        "main_planet": [
          {
            "planet_code": "string",
            "planet_en": "string",
            "planet_cn": "string",
            "planet_name": "示例名称",
            "planet_font": "string"
          }
        ],
        "planet_array": [
          {
            "deg": 0,
            "min": 0,
            "sec": 0,
            "longitude": 0,
            "planet_code": "string",
            "planet_en": "string",
            "planet_cn": "string",
            "planet_name": "示例名称",
            "planet_font": "string"
          }
        ]
      }
    ],
    "attribute": {
      "fire": [
        {
          "planet_en": "string",
          "planet_cn": "string",
          "planet_name": "示例名称",
          "planet_code": "string",
          "longitude": 0,
          "house_id": 0,
          "speed": 0,
          "planet_font": "string",
          "deg": 0,
          "min": 0,
          "sec": 0,
          "sign_id": 0,
          "sign_en": "string",
          "sign_cn": "string",
          "sign_name": "示例名称",
          "sign_font": "string"
        }
      ],
      "soil": [
        {
          "planet_en": "string",
          "planet_cn": "string",
          "planet_name": "示例名称",
          "planet_code": "string",
          "longitude": 0,
          "house_id": 0,
          "speed": 0,
          "planet_font": "string",
          "deg": 0,
          "min": 0,
          "sec": 0,
          "sign_id": 0,
          "sign_en": "string",
          "sign_cn": "string",
          "sign_name": "示例名称",
          "sign_font": "string"
        }
      ],
      "wind": [
        {
          "planet_en": "string",
          "planet_cn": "string",
          "planet_name": "示例名称",
          "planet_code": "string",
          "longitude": 0,
          "house_id": 0,
          "speed": 0,
          "planet_font": "string",
          "deg": 0,
          "min": 0,
          "sec": 0,
          "sign_id": 0,
          "sign_en": "string",
          "sign_cn": "string",
          "sign_name": "示例名称",
          "sign_font": "string"
        }
      ],
      "water": [
        {
          "planet_en": "string",
          "planet_cn": "string",
          "planet_name": "示例名称",
          "planet_code": "string",
          "longitude": 0,
          "house_id": 0,
          "speed": 0,
          "planet_font": "string",
          "deg": 0,
          "min": 0,
          "sec": 0,
          "sign_id": 0,
          "sign_en": "string",
          "sign_cn": "string",
          "sign_name": "示例名称",
          "sign_font": "string"
        }
      ],
      "standard": [
        {
          "planet_en": "string",
          "planet_cn": "string",
          "planet_name": "示例名称",
          "planet_code": "string",
          "longitude": 0,
          "house_id": 0,
          "speed": 0,
          "planet_font": "string",
          "deg": 0,
          "min": 0,
          "sec": 0,
          "sign_id": 0,
          "sign_en": "string",
          "sign_cn": "string",
          "sign_name": "示例名称",
          "sign_font": "string"
        }
      ],
      "fixed": [
        {
          "planet_en": "string",
          "planet_cn": "string",
          "planet_name": "示例名称",
          "planet_code": "string",
          "longitude": 0,
          "house_id": 0,
          "speed": 0,
          "planet_font": "string",
          "deg": 0,
          "min": 0,
          "sec": 0,
          "sign_id": 0,
          "sign_en": "string",
          "sign_cn": "string",
          "sign_name": "示例名称",
          "sign_font": "string"
        }
      ],
      "change": [
        {
          "planet_en": "string",
          "planet_cn": "string",
          "planet_name": "示例名称",
          "planet_code": "string",
          "longitude": 0,
          "house_id": 0,
          "speed": 0,
          "planet_font": "string",
          "deg": 0,
          "min": 0,
          "sec": 0,
          "sign_id": 0,
          "sign_en": "string",
          "sign_cn": "string",
          "sign_name": "示例名称",
          "sign_font": "string"
        }
      ]
    },
    "planet_second": [
      {
        "sign": {
          "deg": 0,
          "min": 0,
          "sec": 0,
          "sign_id": 0,
          "sign_en": "string",
          "sign_cn": "string",
          "sign_name": "示例名称",
          "sign_font": "string"
        },
        "planet_en": "string",
        "planet_cn": "string",
        "planet_name": "示例名称",
        "planet_code": "string",
        "longitude": 0,
        "house_id": 0,
        "speed": 0,
        "planet_font": "string",
        "house_longitude": 0,
        "house_deg": 0,
        "house_min": 0,
        "house_sec": 0
      }
    ],
    "corpus": [
      {
        "chartType": "string",
        "from_cn": "string",
        "to_cn": "string",
        "from_en": "string",
        "to_en": "string",
        "from_name": "示例名称",
        "to_name": "示例名称",
        "type": "string",
        "title": "string",
        "content": "string"
      }
    ],
    "svg": "string",
    "firdaria": {},
    "smalllimit": {},
    "param": {},
    "extra": {}
  },
  "exe_time": 0
}

ApiResp[AstroEventVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataAstroEventVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "chart_type": "string",
    "asp_type": "string",
    "asp_name": "示例名称",
    "from_obj": "string",
    "from_name": "示例名称",
    "to_obj": "string",
    "to_name": "示例名称",
    "event_type": "In",
    "occurred_at": "string"
  },
  "exe_time": 0
}

ApiResp[BaziFlowVO]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataBaziFlowVO | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "target_dt": "string",
    "pillars": [
      {
        "type": "natal_year",
        "tg": "string",
        "dz": "string",
        "gan_shen": "string",
        "gan_shen_short": "string",
        "zhi_shen": [
          "string"
        ],
        "zhi_shen_short": [
          "string"
        ],
        "cang_gan_wx": [
          "string"
        ],
        "cang_gan_zs": [
          "string"
        ],
        "na_yin": "string",
        "kong_wang": "string",
        "di_shi": "string",
        "zi_zuo": "string",
        "shen_sha": [
          "string"
        ]
      }
    ],
    "flow_start_dt": "string",
    "flow_decadal": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "flow_year": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "flow_month": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "flow_day": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "flow_hour": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "tg_chong_ke": [
      "string"
    ],
    "dz_chong_ke": [
      "string"
    ],
    "flow_tg_chong_ke": [
      "string"
    ],
    "flow_dz_chong_ke": [
      "string"
    ]
  },
  "exe_time": 0
}

ApiResp[BaziFullVO]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataBaziFullVO | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "natal": {
      "birth_dt": "string",
      "birth_solar_dt": "string",
      "birth_lunar": "string",
      "birth_solar_term": "string",
      "tg_chong_ke": [
        "string"
      ],
      "dz_chong_ke": [
        "string"
      ],
      "pillars": [
        {
          "type": "natal_year",
          "tg": "string",
          "dz": "string",
          "gan_shen": "string",
          "gan_shen_short": "string",
          "zhi_shen": [
            "string"
          ],
          "zhi_shen_short": [
            "string"
          ],
          "cang_gan_wx": [
            "string"
          ],
          "cang_gan_zs": [
            "string"
          ],
          "na_yin": "string",
          "kong_wang": "string",
          "di_shi": "string",
          "zi_zuo": "string",
          "shen_sha": [
            "string"
          ]
        }
      ],
      "flow_start_dt": "string",
      "flow_decadal": [
        {
          "type": "natal_year",
          "key": "string",
          "tg": "string",
          "tg_shen_sha": "string",
          "dz": "string",
          "dz_shen_sha": "string",
          "is_current": true
        }
      ],
      "wang_xiang": [
        "string"
      ],
      "misc": {
        "tai_yuan": "string",
        "tai_yuan_na_yin": "string",
        "tai_xi": "string",
        "tai_xi_na_yin": "string",
        "ming_gong": "string",
        "ming_gong_na_yin": "string",
        "shen_gong": "string",
        "shen_gong_na_yin": "string",
        "ming_gua": "string",
        "siling_fenye": "string"
      }
    },
    "flow": {
      "target_dt": "string",
      "pillars": [
        {
          "type": "natal_year",
          "tg": "string",
          "dz": "string",
          "gan_shen": "string",
          "gan_shen_short": "string",
          "zhi_shen": [
            "string"
          ],
          "zhi_shen_short": [
            "string"
          ],
          "cang_gan_wx": [
            "string"
          ],
          "cang_gan_zs": [
            "string"
          ],
          "na_yin": "string",
          "kong_wang": "string",
          "di_shi": "string",
          "zi_zuo": "string",
          "shen_sha": [
            "string"
          ]
        }
      ],
      "flow_start_dt": "string",
      "flow_decadal": [
        {
          "type": "natal_year",
          "key": "string",
          "tg": "string",
          "tg_shen_sha": "string",
          "dz": "string",
          "dz_shen_sha": "string",
          "is_current": true
        }
      ],
      "flow_year": [
        {
          "type": "natal_year",
          "key": "string",
          "tg": "string",
          "tg_shen_sha": "string",
          "dz": "string",
          "dz_shen_sha": "string",
          "is_current": true
        }
      ],
      "flow_month": [
        {
          "type": "natal_year",
          "key": "string",
          "tg": "string",
          "tg_shen_sha": "string",
          "dz": "string",
          "dz_shen_sha": "string",
          "is_current": true
        }
      ],
      "flow_day": [
        {
          "type": "natal_year",
          "key": "string",
          "tg": "string",
          "tg_shen_sha": "string",
          "dz": "string",
          "dz_shen_sha": "string",
          "is_current": true
        }
      ],
      "flow_hour": [
        {
          "type": "natal_year",
          "key": "string",
          "tg": "string",
          "tg_shen_sha": "string",
          "dz": "string",
          "dz_shen_sha": "string",
          "is_current": true
        }
      ],
      "tg_chong_ke": [
        "string"
      ],
      "dz_chong_ke": [
        "string"
      ],
      "flow_tg_chong_ke": [
        "string"
      ],
      "flow_dz_chong_ke": [
        "string"
      ]
    },
    "summary": {
      "general_desc": "string",
      "wx_info": [
        {
          "wx": "string",
          "is_day_master": true,
          "ratio": 0,
          "shi_shen": [
            "string"
          ]
        }
      ],
      "yin_yang": "string",
      "yin_yang_desc": "string",
      "qiang_ruo": "string",
      "qiang_ruo_desc": "string",
      "ge_ju": "string",
      "ge_ju_desc": "string",
      "xi_yong_shen": [
        "string"
      ],
      "ji_yong_shen": [
        "string"
      ],
      "lucky_info": {},
      "qi_he_partner": "string",
      "qi_he_partner_desc": "string"
    }
  },
  "exe_time": 0
}

ApiResp[BaziMatchVO]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataBaziMatchVO | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "your_natal": {
      "birth_dt": "string",
      "birth_solar_dt": "string",
      "birth_lunar": "string",
      "birth_solar_term": "string",
      "tg_chong_ke": [
        "string"
      ],
      "dz_chong_ke": [
        "string"
      ],
      "pillars": [
        {
          "type": "natal_year",
          "tg": "string",
          "dz": "string",
          "gan_shen": "string",
          "gan_shen_short": "string",
          "zhi_shen": [
            "string"
          ],
          "zhi_shen_short": [
            "string"
          ],
          "cang_gan_wx": [
            "string"
          ],
          "cang_gan_zs": [
            "string"
          ],
          "na_yin": "string",
          "kong_wang": "string",
          "di_shi": "string",
          "zi_zuo": "string",
          "shen_sha": [
            "string"
          ]
        }
      ],
      "flow_start_dt": "string",
      "flow_decadal": [
        {
          "type": "natal_year",
          "key": "string",
          "tg": "string",
          "tg_shen_sha": "string",
          "dz": "string",
          "dz_shen_sha": "string",
          "is_current": true
        }
      ],
      "wang_xiang": [
        "string"
      ],
      "misc": {
        "tai_yuan": "string",
        "tai_yuan_na_yin": "string",
        "tai_xi": "string",
        "tai_xi_na_yin": "string",
        "ming_gong": "string",
        "ming_gong_na_yin": "string",
        "shen_gong": "string",
        "shen_gong_na_yin": "string",
        "ming_gua": "string",
        "siling_fenye": "string"
      }
    },
    "other_natal": {
      "birth_dt": "string",
      "birth_solar_dt": "string",
      "birth_lunar": "string",
      "birth_solar_term": "string",
      "tg_chong_ke": [
        "string"
      ],
      "dz_chong_ke": [
        "string"
      ],
      "pillars": [
        {
          "type": "natal_year",
          "tg": "string",
          "dz": "string",
          "gan_shen": "string",
          "gan_shen_short": "string",
          "zhi_shen": [
            "string"
          ],
          "zhi_shen_short": [
            "string"
          ],
          "cang_gan_wx": [
            "string"
          ],
          "cang_gan_zs": [
            "string"
          ],
          "na_yin": "string",
          "kong_wang": "string",
          "di_shi": "string",
          "zi_zuo": "string",
          "shen_sha": [
            "string"
          ]
        }
      ],
      "flow_start_dt": "string",
      "flow_decadal": [
        {
          "type": "natal_year",
          "key": "string",
          "tg": "string",
          "tg_shen_sha": "string",
          "dz": "string",
          "dz_shen_sha": "string",
          "is_current": true
        }
      ],
      "wang_xiang": [
        "string"
      ],
      "misc": {
        "tai_yuan": "string",
        "tai_yuan_na_yin": "string",
        "tai_xi": "string",
        "tai_xi_na_yin": "string",
        "ming_gong": "string",
        "ming_gong_na_yin": "string",
        "shen_gong": "string",
        "shen_gong_na_yin": "string",
        "ming_gua": "string",
        "siling_fenye": "string"
      }
    },
    "interpretation": "string"
  },
  "exe_time": 0
}

ApiResp[BaziNatalVO]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataBaziNatalVO | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "birth_dt": "string",
    "birth_solar_dt": "string",
    "birth_lunar": "string",
    "birth_solar_term": "string",
    "tg_chong_ke": [
      "string"
    ],
    "dz_chong_ke": [
      "string"
    ],
    "pillars": [
      {
        "type": "natal_year",
        "tg": "string",
        "dz": "string",
        "gan_shen": "string",
        "gan_shen_short": "string",
        "zhi_shen": [
          "string"
        ],
        "zhi_shen_short": [
          "string"
        ],
        "cang_gan_wx": [
          "string"
        ],
        "cang_gan_zs": [
          "string"
        ],
        "na_yin": "string",
        "kong_wang": "string",
        "di_shi": "string",
        "zi_zuo": "string",
        "shen_sha": [
          "string"
        ]
      }
    ],
    "flow_start_dt": "string",
    "flow_decadal": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "wang_xiang": [
      "string"
    ],
    "misc": {
      "tai_yuan": "string",
      "tai_yuan_na_yin": "string",
      "tai_xi": "string",
      "tai_xi_na_yin": "string",
      "ming_gong": "string",
      "ming_gong_na_yin": "string",
      "shen_gong": "string",
      "shen_gong_na_yin": "string",
      "ming_gua": "string",
      "siling_fenye": "string"
    }
  },
  "exe_time": 0
}

ApiResp[BaziSummaryVO]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataBaziSummaryVO | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "general_desc": "string",
    "wx_info": [
      {
        "wx": "string",
        "is_day_master": true,
        "ratio": 0,
        "shi_shen": [
          "string"
        ]
      }
    ],
    "yin_yang": "string",
    "yin_yang_desc": "string",
    "qiang_ruo": "string",
    "qiang_ruo_desc": "string",
    "ge_ju": "string",
    "ge_ju_desc": "string",
    "xi_yong_shen": [
      "string"
    ],
    "ji_yong_shen": [
      "string"
    ],
    "lucky_info": {},
    "qi_he_partner": "string",
    "qi_he_partner_desc": "string"
  },
  "exe_time": 0
}

ApiResp[DailyMoodVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataDailyMoodVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "scope_info": [
      {
        "label": "string",
        "icon": "string",
        "color": "string",
        "val": 0,
        "content": "string"
      }
    ],
    "scope_total": {
      "label": "string",
      "val": 0,
      "start_date": "2024-01-01",
      "end_date": "2024-01-01",
      "tips": "string"
    },
    "comment": {
      "prefer": "",
      "avoid": "",
      "summary": ""
    }
  },
  "exe_time": 0
}

ApiResp[List[app.client.dto.event.resp.astro_event_vo.AstroEventVo]]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataarray<AstroEventVo> | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": [
    {
      "chart_type": "string",
      "asp_type": "string",
      "from_obj": "string",
      "to_obj": "string",
      "occurred_at": "string"
    }
  ],
  "exe_time": 0
}

ApiResp[LiurenResultVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataLiurenResultVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "input_time": "2024-01-01T00:00:00Z",
    "true_solar_time": "2024-01-01T00:00:00Z",
    "lunar": "string",
    "weekday_cn": "string",
    "type": "string",
    "gui_method": "string",
    "di_fen": "string",
    "solar_term": "string",
    "jie_qi_prev": {
      "name": "示例名称",
      "jiaojie_local": "string"
    },
    "jie_qi_next": {
      "name": "示例名称",
      "jiaojie_local": "string"
    },
    "year_pillar": {
      "label": "string",
      "kong_wang": "string"
    },
    "month_pillar": {
      "label": "string",
      "kong_wang": "string"
    },
    "day_pillar": {
      "label": "string",
      "kong_wang": "string"
    },
    "hour_pillar": {
      "label": "string",
      "kong_wang": "string"
    },
    "year_gan_zhi": "string",
    "month_gan_zhi": "string",
    "day_gan_zhi": "string",
    "shi_gan_zhi": "string",
    "yue_jiang": "string",
    "yue_jiang_name": "示例名称",
    "shi": "string",
    "ge_ju": [
      "string"
    ],
    "ge_ju_detail": [
      {
        "name": "示例名称"
      }
    ],
    "ri_ma": "string",
    "tian_pan": {},
    "di_pan": {},
    "tian_jiang": {},
    "tian_jiang_on_earth": {},
    "palace_notes": {},
    "si_ke": [
      {
        "name": "示例名称",
        "tian": "string"
      }
    ],
    "san_chuan": [
      {
        "name": "示例名称",
        "zhi": "string",
        "gan_zhi": "string",
        "tian_jiang": "string",
        "liu_qin": "string",
        "shen": "string"
      }
    ]
  },
  "exe_time": 0
}

ApiResp[MySignRespVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataMySignRespVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "hidden_skill": "12345",
    "matched_signs": "string",
    "luck_info": [
      {
        "label": "string",
        "val": "string",
        "icon": "string"
      }
    ],
    "scope_prefer": "string",
    "scope_avoid": "12345",
    "scope_summary": "string",
    "sign_explains": [
      {
        "label": "string",
        "pl": "string",
        "sign": "string",
        "tag": "string",
        "tag_img": "string",
        "summary": null
      }
    ]
  },
  "exe_time": 0
}

ApiResp[NaksVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataNaksVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "natal_naks_info": {
      "idx": 0,
      "name": "示例名称",
      "user_id": "12345",
      "tip": "",
      "brief": ""
    },
    "daily_naks_info": {
      "idx": 0,
      "name": "示例名称",
      "user_id": "12345",
      "tip": "",
      "brief": ""
    },
    "others_natal_relation": [],
    "others_daily_relation": [],
    "natal_interps": [],
    "daily_interps": [],
    "analysis_time": "2024-01-01T00:00:00Z"
  },
  "exe_time": 0
}

ApiResp[QimenResultVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataQimenResultVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "input_time": "2024-01-01T00:00:00Z",
    "true_solar_time": "2024-01-01T00:00:00Z",
    "lunar": "string",
    "weekday_cn": "string",
    "pai_fa": {
      "digest": "string",
      "qiju_type": "string",
      "ju_method": "string",
      "pai_method": "string",
      "ju_lineage": "string"
    },
    "type": "string",
    "ju_method": "string",
    "pai_method": "string",
    "jie_qi_prev": {
      "name": "示例名称",
      "jiaojie_local": "string"
    },
    "jie_qi_next": {
      "name": "示例名称",
      "jiaojie_local": "string"
    },
    "year_pillar": {
      "label": "string",
      "kong_wang": "string"
    },
    "month_pillar": {
      "label": "string",
      "kong_wang": "string"
    },
    "day_pillar": {
      "label": "string",
      "kong_wang": "string"
    },
    "gender": "string",
    "location": "string",
    "nian_ming": "string",
    "liuren_data": {},
    "year_gan_zhi": "string",
    "month_gan_zhi": "string",
    "day_gan_zhi": "string",
    "pan_variant": "shijia_chaibu",
    "shan_xiang": {
      "shan_mount": "string",
      "xiang_mount": "string",
      "yuan": "shang",
      "yuan_label": "string",
      "event_year": 0,
      "equivalent_day": "string",
      "equivalent_hour": "string"
    },
    "yin_yang": "yang",
    "ju_display": "string",
    "solar_term": "string",
    "ding_ju_term": "string",
    "ju_num": 1,
    "yuan": "string",
    "hour_pillar": {
      "label": "string",
      "kong_wang": "string"
    },
    "xun_shou": "string",
    "zhi_fu": "string",
    "zhi_shi": "string",
    "tian_yi": "string",
    "special_patterns": [
      {
        "code": "string",
        "name": "示例名称",
        "category": "timing"
      }
    ],
    "jiu_gong": {},
    "huang_hei_dao": [
      {
        "hour_branch": "string",
        "hour_label": "string",
        "god_code": "string",
        "god_name": "示例名称",
        "dao_type": "huang",
        "auspicious": true
      }
    ],
    "shi_gan_zhi": "string"
  },
  "exe_time": 0
}

ApiResp[QimenSelectResultVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataQimenSelectResultVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "qry_dt": "string",
    "days": 0,
    "matter": "string",
    "best": [
      {
        "dt": "string",
        "hour_label": "string",
        "score": 0,
        "level": "string",
        "level_cn": "string"
      }
    ],
    "avoid": [
      {
        "dt": "string",
        "hour_label": "string",
        "score": 0,
        "level": "string",
        "level_cn": "string"
      }
    ],
    "hours": [
      {
        "dt": "string",
        "hour_label": "string",
        "day_pillar": "string",
        "hour_pillar": "string",
        "zhi_shi_men": "string",
        "zhi_fu_star": "string",
        "score": 0,
        "level": "string",
        "level_cn": "string"
      }
    ]
  },
  "exe_time": 0
}

ApiResp[QizhengChartVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataQizhengChartVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "gender": "string",
    "birth_dt": "string",
    "solar_dt": "string",
    "basic": {
      "pillars": {
        "year": {
          "stem": "string",
          "branch": "string",
          "stem_label": "",
          "branch_label": "",
          "gan_zhi": ""
        },
        "month": {
          "stem": "string",
          "branch": "string",
          "stem_label": "",
          "branch_label": "",
          "gan_zhi": ""
        },
        "day": {
          "stem": "string",
          "branch": "string",
          "stem_label": "",
          "branch_label": "",
          "gan_zhi": ""
        },
        "hour": {
          "stem": "string",
          "branch": "string",
          "stem_label": "",
          "branch_label": "",
          "gan_zhi": ""
        }
      },
      "lunar_date": "",
      "is_day": true,
      "day_night_label": "",
      "jie_qi": [
        {
          "name": "示例名称",
          "at": "string"
        }
      ],
      "grace": {
        "degree": {
          "self_wx": "wood",
          "self_wx_label": "",
          "grace": "wood",
          "grace_label": "",
          "useful": "wood",
          "useful_label": "",
          "foe": "wood",
          "foe_label": "",
          "hardship": "wood",
          "hardship_label": ""
        },
        "palace": {
          "self_wx": "wood",
          "self_wx_label": "",
          "grace": "wood",
          "grace_label": "",
          "useful": "wood",
          "useful_label": "",
          "foe": "wood",
          "foe_label": "",
          "hardship": "wood",
          "hardship_label": ""
        }
      },
      "shen": {
        "palace_degree": 0,
        "xiu": "jiao",
        "xiu_label": "",
        "xiu_degree": 0,
        "earthly_branch": "zi",
        "earthly_branch_label": ""
      },
      "tong_xian_span": {
        "years": 0,
        "months": 0,
        "days": 0,
        "exit_date": "2024-01-01",
        "label": ""
      }
    },
    "ming": {
      "palace_degree": 0,
      "xiu": "jiao",
      "xiu_label": "",
      "xiu_degree": 0,
      "lord": "wood",
      "lord_label": "",
      "lord_type_label": ""
    },
    "stars": [
      {
        "key": "sun",
        "longitude": 0,
        "speed": 0,
        "palace_degree": 0,
        "xiu_degree": {
          "xiu": "jiao",
          "degree": 0
        },
        "palace_index": 0
      }
    ],
    "palaces": [
      {
        "index": 0,
        "key": "ming",
        "earthly_branch": "zi"
      }
    ],
    "xiu_spans": [
      {
        "xiu": "jiao",
        "longitude_start": 0,
        "longitude_end": 0,
        "lord": "wood"
      }
    ],
    "hua_yao_groups": [
      {
        "primary": {
          "key": "string",
          "natal_star": "sun"
        }
      }
    ],
    "aspects": [
      {
        "from_star": "sun",
        "to_star": "sun",
        "type": "conjunct",
        "angle": 0,
        "orb": 0
      }
    ],
    "patterns": [
      {
        "key": "string",
        "type": "lucky"
      }
    ],
    "dongwei_segments": [
      {
        "sequence": 0,
        "palace_index": 0,
        "palace_key": "ming",
        "earthly_branch": "zi",
        "span_years": 0,
        "start_age": 0,
        "end_age": 0,
        "start_year": 0,
        "end_year": 0
      }
    ],
    "reading": {
      "summary": "",
      "highlights": [
        {
          "kind": "string",
          "key": "string"
        }
      ],
      "timing": {
        "title": "",
        "body": "",
        "items": [
          {
            "kind": "string",
            "key": "string"
          }
        ]
      },
      "relation": {
        "title": "",
        "body": "",
        "items": [
          {
            "kind": "string",
            "key": "string"
          }
        ]
      }
    },
    "target_dt": "string",
    "flow_year_stem": "",
    "flow_year_branch": "",
    "flow_stars": [
      {
        "key": "sun",
        "longitude": 0,
        "speed": 0,
        "palace_degree": 0,
        "xiu_degree": {
          "xiu": "jiao",
          "degree": 0
        },
        "palace_index": 0
      }
    ],
    "flow_aspects": [
      {
        "from_star": "sun",
        "to_star": "sun",
        "type": "conjunct",
        "angle": 0,
        "orb": 0
      }
    ],
    "current_limits": {
      "xiao_xian": "zi",
      "xiao_xian_label": "",
      "yue_xian": "zi",
      "yue_xian_label": "",
      "fei_xian": "zi",
      "fei_xian_label": "",
      "tong_xian": "zi",
      "tong_xian_label": "",
      "da_xian_palace": "ming",
      "da_xian_palace_label": "",
      "da_xian_start_age": 0,
      "da_xian_end_age": 0,
      "chan_ri": "wood",
      "chan_ri_label": "",
      "ding_du": {
        "longitude": 0,
        "earthly_branch": "zi",
        "earthly_branch_label": "",
        "palace_degree": 0,
        "xiu": "jiao",
        "xiu_label": "",
        "xiu_degree": 0,
        "lord": "wood",
        "lord_label": ""
      }
    },
    "limit_years": [
      {
        "age": 1,
        "year": 0,
        "xiao_xian": "zi",
        "fei_xian": "zi"
      }
    ]
  },
  "exe_time": 0
}

ApiResp[QizhengComparisonVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataQizhengComparisonVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "gender": "string",
    "birth_dt": "string",
    "solar_dt": "string",
    "basic": {
      "pillars": {
        "year": {
          "stem": "string",
          "branch": "string",
          "stem_label": "",
          "branch_label": "",
          "gan_zhi": ""
        },
        "month": {
          "stem": "string",
          "branch": "string",
          "stem_label": "",
          "branch_label": "",
          "gan_zhi": ""
        },
        "day": {
          "stem": "string",
          "branch": "string",
          "stem_label": "",
          "branch_label": "",
          "gan_zhi": ""
        },
        "hour": {
          "stem": "string",
          "branch": "string",
          "stem_label": "",
          "branch_label": "",
          "gan_zhi": ""
        }
      },
      "lunar_date": "",
      "is_day": true,
      "day_night_label": "",
      "jie_qi": [
        {
          "name": "示例名称",
          "at": "string"
        }
      ],
      "grace": {
        "degree": {
          "self_wx": "wood",
          "self_wx_label": "",
          "grace": "wood",
          "grace_label": "",
          "useful": "wood",
          "useful_label": "",
          "foe": "wood",
          "foe_label": "",
          "hardship": "wood",
          "hardship_label": ""
        },
        "palace": {
          "self_wx": "wood",
          "self_wx_label": "",
          "grace": "wood",
          "grace_label": "",
          "useful": "wood",
          "useful_label": "",
          "foe": "wood",
          "foe_label": "",
          "hardship": "wood",
          "hardship_label": ""
        }
      },
      "shen": {
        "palace_degree": 0,
        "xiu": "jiao",
        "xiu_label": "",
        "xiu_degree": 0,
        "earthly_branch": "zi",
        "earthly_branch_label": ""
      },
      "tong_xian_span": {
        "years": 0,
        "months": 0,
        "days": 0,
        "exit_date": "2024-01-01",
        "label": ""
      }
    },
    "ming": {
      "palace_degree": 0,
      "xiu": "jiao",
      "xiu_label": "",
      "xiu_degree": 0,
      "lord": "wood",
      "lord_label": "",
      "lord_type_label": ""
    },
    "stars": [
      {
        "key": "sun",
        "longitude": 0,
        "speed": 0,
        "palace_degree": 0,
        "xiu_degree": {
          "xiu": "jiao",
          "degree": 0
        },
        "palace_index": 0
      }
    ],
    "palaces": [
      {
        "index": 0,
        "key": "ming",
        "earthly_branch": "zi"
      }
    ],
    "xiu_spans": [
      {
        "xiu": "jiao",
        "longitude_start": 0,
        "longitude_end": 0,
        "lord": "wood"
      }
    ],
    "hua_yao_groups": [
      {
        "primary": {
          "key": "string",
          "natal_star": "sun"
        }
      }
    ],
    "aspects": [
      {
        "from_star": "sun",
        "to_star": "sun",
        "type": "conjunct",
        "angle": 0,
        "orb": 0
      }
    ],
    "patterns": [
      {
        "key": "string",
        "type": "lucky"
      }
    ],
    "dongwei_segments": [
      {
        "sequence": 0,
        "palace_index": 0,
        "palace_key": "ming",
        "earthly_branch": "zi",
        "span_years": 0,
        "start_age": 0,
        "end_age": 0,
        "start_year": 0,
        "end_year": 0
      }
    ],
    "reading": {
      "summary": "",
      "highlights": [
        {
          "kind": "string",
          "key": "string"
        }
      ],
      "timing": {
        "title": "",
        "body": "",
        "items": [
          {
            "kind": "string",
            "key": "string"
          }
        ]
      },
      "relation": {
        "title": "",
        "body": "",
        "items": [
          {
            "kind": "string",
            "key": "string"
          }
        ]
      }
    },
    "other_gender": "string",
    "other_birth_dt": "string",
    "other_solar_dt": "string",
    "other_ming": {
      "palace_degree": 0,
      "xiu": "jiao",
      "xiu_label": "",
      "xiu_degree": 0,
      "lord": "wood",
      "lord_label": "",
      "lord_type_label": ""
    },
    "flow_stars": [
      {
        "key": "sun",
        "longitude": 0,
        "speed": 0,
        "palace_degree": 0,
        "xiu_degree": {
          "xiu": "jiao",
          "degree": 0
        },
        "palace_index": 0
      }
    ],
    "flow_aspects": [
      {
        "from_star": "sun",
        "to_star": "sun",
        "type": "conjunct",
        "angle": 0,
        "orb": 0
      }
    ]
  },
  "exe_time": 0
}

ApiResp[QizhengNatalVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataQizhengNatalVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "gender": "string",
    "birth_dt": "string",
    "solar_dt": "string",
    "basic": {
      "pillars": {
        "year": {
          "stem": "string",
          "branch": "string",
          "stem_label": "",
          "branch_label": "",
          "gan_zhi": ""
        },
        "month": {
          "stem": "string",
          "branch": "string",
          "stem_label": "",
          "branch_label": "",
          "gan_zhi": ""
        },
        "day": {
          "stem": "string",
          "branch": "string",
          "stem_label": "",
          "branch_label": "",
          "gan_zhi": ""
        },
        "hour": {
          "stem": "string",
          "branch": "string",
          "stem_label": "",
          "branch_label": "",
          "gan_zhi": ""
        }
      },
      "lunar_date": "",
      "is_day": true,
      "day_night_label": "",
      "jie_qi": [
        {
          "name": "示例名称",
          "at": "string"
        }
      ],
      "grace": {
        "degree": {
          "self_wx": "wood",
          "self_wx_label": "",
          "grace": "wood",
          "grace_label": "",
          "useful": "wood",
          "useful_label": "",
          "foe": "wood",
          "foe_label": "",
          "hardship": "wood",
          "hardship_label": ""
        },
        "palace": {
          "self_wx": "wood",
          "self_wx_label": "",
          "grace": "wood",
          "grace_label": "",
          "useful": "wood",
          "useful_label": "",
          "foe": "wood",
          "foe_label": "",
          "hardship": "wood",
          "hardship_label": ""
        }
      },
      "shen": {
        "palace_degree": 0,
        "xiu": "jiao",
        "xiu_label": "",
        "xiu_degree": 0,
        "earthly_branch": "zi",
        "earthly_branch_label": ""
      },
      "tong_xian_span": {
        "years": 0,
        "months": 0,
        "days": 0,
        "exit_date": "2024-01-01",
        "label": ""
      }
    },
    "ming": {
      "palace_degree": 0,
      "xiu": "jiao",
      "xiu_label": "",
      "xiu_degree": 0,
      "lord": "wood",
      "lord_label": "",
      "lord_type_label": ""
    },
    "stars": [
      {
        "key": "sun",
        "longitude": 0,
        "speed": 0,
        "palace_degree": 0,
        "xiu_degree": {
          "xiu": "jiao",
          "degree": 0
        },
        "palace_index": 0
      }
    ],
    "palaces": [
      {
        "index": 0,
        "key": "ming",
        "earthly_branch": "zi"
      }
    ],
    "xiu_spans": [
      {
        "xiu": "jiao",
        "longitude_start": 0,
        "longitude_end": 0,
        "lord": "wood"
      }
    ],
    "hua_yao_groups": [
      {
        "primary": {
          "key": "string",
          "natal_star": "sun"
        }
      }
    ],
    "aspects": [
      {
        "from_star": "sun",
        "to_star": "sun",
        "type": "conjunct",
        "angle": 0,
        "orb": 0
      }
    ],
    "patterns": [
      {
        "key": "string",
        "type": "lucky"
      }
    ],
    "dongwei_segments": [
      {
        "sequence": 0,
        "palace_index": 0,
        "palace_key": "ming",
        "earthly_branch": "zi",
        "span_years": 0,
        "start_age": 0,
        "end_age": 0,
        "start_year": 0,
        "end_year": 0
      }
    ],
    "reading": {
      "summary": "",
      "highlights": [
        {
          "kind": "string",
          "key": "string"
        }
      ],
      "timing": {
        "title": "",
        "body": "",
        "items": [
          {
            "kind": "string",
            "key": "string"
          }
        ]
      },
      "relation": {
        "title": "",
        "body": "",
        "items": [
          {
            "kind": "string",
            "key": "string"
          }
        ]
      }
    }
  },
  "exe_time": 0
}

ApiResp[ScopeRespVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataScopeRespVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "scope_info": [
      {
        "label": "string",
        "icon": "string",
        "color": "string",
        "val": 0,
        "content": "string"
      }
    ],
    "scope_total": {
      "label": "string",
      "val": 0,
      "start_date": "2024-01-01",
      "end_date": "2024-01-01",
      "tips": "string"
    },
    "comment": {
      "prefer": "",
      "avoid": "",
      "summary": ""
    },
    "luck_info": [
      {
        "label": "string",
        "val": "string",
        "icon": "string"
      }
    ],
    "sign_info": {
      "sign_name": "",
      "sign_icon": ""
    },
    "corpus": [
      {
        "chartType": "string",
        "from_cn": "string",
        "to_cn": "string",
        "from_en": "string",
        "to_en": "string",
        "from_name": "示例名称",
        "to_name": "示例名称",
        "type": "string",
        "title": "string",
        "content": "string"
      }
    ]
  },
  "exe_time": 0
}

ApiResp[SignVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataapp__client__dto__sign__resp__sign_vo__SignVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "id": 0,
    "name": "示例名称",
    "en_name": "示例名称",
    "attr": "string",
    "img_url": "https://api.apiworks.com",
    "rec_img_url": "https://api.apiworks.com",
    "circle_img_url": "https://api.apiworks.com",
    "date": "2024-01-01",
    "details": [
      {}
    ]
  },
  "exe_time": 0
}

ApiResp[ZiweiChartVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataZiweiChartVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "gender": "string",
    "birth_date": "2024-01-01",
    "solar_date": "2024-01-01",
    "lunar_date": "2024-01-01",
    "lunar_ganzhi": "string",
    "solar_term_ganzhi": "string",
    "zodiac": "string",
    "five_elements_class": "string",
    "natal_palace_idx": 0,
    "body_palace_idx": 0,
    "soul_lord": "string",
    "body_lord": "string",
    "birth_year_doujun": "string",
    "natal": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称",
          "heavenly_stem": "string",
          "earthly_branch": "string",
          "life_12_star": "string"
        }
      ]
    },
    "patterns": [
      {
        "name": "示例名称",
        "description": "string",
        "type": "string"
      }
    ],
    "current_year_doujun": "string",
    "decadal": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称"
        }
      ]
    },
    "yearly": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称"
        }
      ]
    },
    "monthly": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称"
        }
      ]
    },
    "daily": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称"
        }
      ]
    },
    "hourly": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称"
        }
      ]
    }
  },
  "exe_time": 0
}

ApiResp[ZiweiDetailVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataZiweiDetailVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "gender": "string",
    "birth_date": "2024-01-01",
    "solar_date": "2024-01-01",
    "lunar_date": "2024-01-01",
    "lunar_ganzhi": "string",
    "solar_term_ganzhi": "string",
    "zodiac": "string",
    "five_elements_class": "string",
    "natal_palace_idx": 0,
    "body_palace_idx": 0,
    "soul_lord": "string",
    "body_lord": "string",
    "birth_year_doujun": "string",
    "natal": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称",
          "heavenly_stem": "string",
          "earthly_branch": "string",
          "life_12_star": "string"
        }
      ]
    },
    "patterns": [
      {
        "name": "示例名称",
        "description": "string",
        "type": "string"
      }
    ],
    "current_year_doujun": "string",
    "decadal": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称"
        }
      ]
    },
    "yearly": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称"
        }
      ]
    },
    "monthly": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称"
        }
      ]
    },
    "daily": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称"
        }
      ]
    },
    "hourly": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称"
        }
      ]
    },
    "natal_star_interps": [
      {
        "star_name": "示例名称",
        "palace_name": "示例名称",
        "interpretation": "string"
      }
    ],
    "decadal_star_interps": [
      {
        "star_name": "示例名称",
        "palace_name": "示例名称",
        "interpretation": "string"
      }
    ],
    "yearly_star_interps": [
      {
        "star_name": "示例名称",
        "palace_name": "示例名称",
        "interpretation": "string"
      }
    ],
    "monthly_star_interps": [
      {
        "star_name": "示例名称",
        "palace_name": "示例名称",
        "interpretation": "string"
      }
    ],
    "daily_star_interps": [
      {
        "star_name": "示例名称",
        "palace_name": "示例名称",
        "interpretation": "string"
      }
    ],
    "hourly_star_interps": [
      {
        "star_name": "示例名称",
        "palace_name": "示例名称",
        "interpretation": "string"
      }
    ]
  },
  "exe_time": 0
}

ApiResp[ZiweiMatchVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataZiweiMatchVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "self_natal": {
      "gender": "string",
      "birth_date": "2024-01-01",
      "solar_date": "2024-01-01",
      "lunar_date": "2024-01-01",
      "lunar_ganzhi": "string",
      "solar_term_ganzhi": "string",
      "zodiac": "string",
      "five_elements_class": "string",
      "natal_palace_idx": 0,
      "body_palace_idx": 0,
      "soul_lord": "string",
      "body_lord": "string",
      "birth_year_doujun": "string",
      "natal": {
        "mutagen_stars": {},
        "palaces": [
          {
            "index": 0,
            "name": "示例名称",
            "heavenly_stem": "string",
            "earthly_branch": "string",
            "life_12_star": "string"
          }
        ]
      },
      "patterns": [
        {
          "name": "示例名称",
          "description": "string",
          "type": "string"
        }
      ]
    },
    "other_natal": {
      "gender": "string",
      "birth_date": "2024-01-01",
      "solar_date": "2024-01-01",
      "lunar_date": "2024-01-01",
      "lunar_ganzhi": "string",
      "solar_term_ganzhi": "string",
      "zodiac": "string",
      "five_elements_class": "string",
      "natal_palace_idx": 0,
      "body_palace_idx": 0,
      "soul_lord": "string",
      "body_lord": "string",
      "birth_year_doujun": "string",
      "natal": {
        "mutagen_stars": {},
        "palaces": [
          {
            "index": 0,
            "name": "示例名称",
            "heavenly_stem": "string",
            "earthly_branch": "string",
            "life_12_star": "string"
          }
        ]
      },
      "patterns": [
        {
          "name": "示例名称",
          "description": "string",
          "type": "string"
        }
      ]
    },
    "influence_on_self": {
      "year_stem": "string",
      "year_stem_label": "",
      "mutagen_config": "",
      "sihua": [
        {
          "mutagen_type": "string",
          "star_name": "示例名称",
          "palace_name": "示例名称",
          "palace_index": 0
        }
      ],
      "aux_stars": [
        {
          "star_name": "示例名称",
          "palace_name": "示例名称",
          "palace_index": 0
        }
      ],
      "sihua_lines": [
        "string"
      ],
      "aux_line": ""
    },
    "influence_on_other": {
      "year_stem": "string",
      "year_stem_label": "",
      "mutagen_config": "",
      "sihua": [
        {
          "mutagen_type": "string",
          "star_name": "示例名称",
          "palace_name": "示例名称",
          "palace_index": 0
        }
      ],
      "aux_stars": [
        {
          "star_name": "示例名称",
          "palace_name": "示例名称",
          "palace_index": 0
        }
      ],
      "sihua_lines": [
        "string"
      ],
      "aux_line": ""
    }
  },
  "exe_time": 0
}

ApiResp[ZiweiNatalVo]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataZiweiNatalVo | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {
    "gender": "string",
    "birth_date": "2024-01-01",
    "solar_date": "2024-01-01",
    "lunar_date": "2024-01-01",
    "lunar_ganzhi": "string",
    "solar_term_ganzhi": "string",
    "zodiac": "string",
    "five_elements_class": "string",
    "natal_palace_idx": 0,
    "body_palace_idx": 0,
    "soul_lord": "string",
    "body_lord": "string",
    "birth_year_doujun": "string",
    "natal": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称",
          "heavenly_stem": "string",
          "earthly_branch": "string",
          "life_12_star": "string"
        }
      ]
    },
    "patterns": [
      {
        "name": "示例名称",
        "description": "string",
        "type": "string"
      }
    ]
  },
  "exe_time": 0
}

ApiResp[dict[int, list[SignCompatVo]]]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataobject | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": {},
  "exe_time": 0
}

ApiResp[list[SignVo]]

object

字段定义

codeinteger非空

响应状态码

msgstring | null

响应消息

dataarray<app__client__dto__sign__resp__sign_vo__SignVo> | null

响应数据，可以是任意类型

exe_timenumber

执行时间

默认值: 0

示例数据

{
  "code": 0,
  "msg": "string",
  "data": [
    {
      "id": 0,
      "name": "示例名称",
      "en_name": "示例名称"
    }
  ],
  "exe_time": 0
}

AstroDataVo

object

星盘API接口返回的视图对象

字段定义

signarray<app__client__dto__chart__resp__sign_vo__SignVo>

星座信息

planetarray<PlanetVo>

行星信息

housearray<HouseVo>

宫位信息

attributeAttributeVo | null

属性信息

planet_secondarray<PlanetVo> | null

双点图外圈行星信息

corpusarray<CorpusVo> | null

语料信息

svgstring | null

星盘SVG

firdariaobject | null

法达盘数据

smalllimitobject | null

小限盘数据

paramobject | null

请求参数快照

extraobject | null

额外扩展信息

示例数据

{
  "sign": [
    {
      "sign_id": 0,
      "sign_en": "string",
      "sign_cn": "string",
      "sign_name": "示例名称",
      "sign_font": "string",
      "sign_attribute": [
        "string"
      ],
      "sign_guardian": [
        {
          "planet_code": "string",
          "planet_en": "string",
          "planet_cn": "string",
          "planet_name": "示例名称",
          "planet_font": "string"
        }
      ],
      "planet_array": [
        {
          "planet_code": "string",
          "planet_en": "string",
          "planet_cn": "string",
          "planet_name": "示例名称",
          "longitude": 0,
          "house_id": 0,
          "speed": 0,
          "planet_font": "string",
          "deg": 0,
          "min": 0,
          "sec": 0
        }
      ]
    }
  ],
  "planet": [
    {
      "sign": {
        "deg": 0,
        "min": 0,
        "sec": 0,
        "sign_id": 0,
        "sign_en": "string",
        "sign_cn": "string",
        "sign_name": "示例名称",
        "sign_font": "string"
      },
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "planet_code": "string",
      "longitude": 0,
      "house_id": 0,
      "speed": 0,
      "planet_font": "string",
      "house_longitude": 0,
      "house_deg": 0,
      "house_min": 0,
      "house_sec": 0
    }
  ],
  "house": [
    {
      "sign": {
        "deg": 0,
        "min": 0,
        "sec": 0,
        "sign_id": 0,
        "sign_en": "string",
        "sign_cn": "string",
        "sign_name": "示例名称",
        "sign_font": "string"
      },
      "longitude": 0,
      "house_id": 0,
      "house_life": "string",
      "main_planet": [
        {
          "planet_code": "string",
          "planet_en": "string",
          "planet_cn": "string",
          "planet_name": "示例名称",
          "planet_font": "string"
        }
      ],
      "planet_array": [
        {
          "deg": 0,
          "min": 0,
          "sec": 0,
          "longitude": 0,
          "planet_code": "string",
          "planet_en": "string",
          "planet_cn": "string",
          "planet_name": "示例名称",
          "planet_font": "string"
        }
      ]
    }
  ],
  "attribute": {
    "fire": [
      {
        "planet_en": "string",
        "planet_cn": "string",
        "planet_name": "示例名称",
        "planet_code": "string",
        "longitude": 0,
        "house_id": 0,
        "speed": 0,
        "planet_font": "string",
        "deg": 0,
        "min": 0,
        "sec": 0,
        "sign_id": 0,
        "sign_en": "string",
        "sign_cn": "string",
        "sign_name": "示例名称",
        "sign_font": "string"
      }
    ],
    "soil": [
      {
        "planet_en": "string",
        "planet_cn": "string",
        "planet_name": "示例名称",
        "planet_code": "string",
        "longitude": 0,
        "house_id": 0,
        "speed": 0,
        "planet_font": "string",
        "deg": 0,
        "min": 0,
        "sec": 0,
        "sign_id": 0,
        "sign_en": "string",
        "sign_cn": "string",
        "sign_name": "示例名称",
        "sign_font": "string"
      }
    ],
    "wind": [
      {
        "planet_en": "string",
        "planet_cn": "string",
        "planet_name": "示例名称",
        "planet_code": "string",
        "longitude": 0,
        "house_id": 0,
        "speed": 0,
        "planet_font": "string",
        "deg": 0,
        "min": 0,
        "sec": 0,
        "sign_id": 0,
        "sign_en": "string",
        "sign_cn": "string",
        "sign_name": "示例名称",
        "sign_font": "string"
      }
    ],
    "water": [
      {
        "planet_en": "string",
        "planet_cn": "string",
        "planet_name": "示例名称",
        "planet_code": "string",
        "longitude": 0,
        "house_id": 0,
        "speed": 0,
        "planet_font": "string",
        "deg": 0,
        "min": 0,
        "sec": 0,
        "sign_id": 0,
        "sign_en": "string",
        "sign_cn": "string",
        "sign_name": "示例名称",
        "sign_font": "string"
      }
    ],
    "standard": [
      {
        "planet_en": "string",
        "planet_cn": "string",
        "planet_name": "示例名称",
        "planet_code": "string",
        "longitude": 0,
        "house_id": 0,
        "speed": 0,
        "planet_font": "string",
        "deg": 0,
        "min": 0,
        "sec": 0,
        "sign_id": 0,
        "sign_en": "string",
        "sign_cn": "string",
        "sign_name": "示例名称",
        "sign_font": "string"
      }
    ],
    "fixed": [
      {
        "planet_en": "string",
        "planet_cn": "string",
        "planet_name": "示例名称",
        "planet_code": "string",
        "longitude": 0,
        "house_id": 0,
        "speed": 0,
        "planet_font": "string",
        "deg": 0,
        "min": 0,
        "sec": 0,
        "sign_id": 0,
        "sign_en": "string",
        "sign_cn": "string",
        "sign_name": "示例名称",
        "sign_font": "string"
      }
    ],
    "change": [
      {
        "planet_en": "string",
        "planet_cn": "string",
        "planet_name": "示例名称",
        "planet_code": "string",
        "longitude": 0,
        "house_id": 0,
        "speed": 0,
        "planet_font": "string",
        "deg": 0,
        "min": 0,
        "sec": 0,
        "sign_id": 0,
        "sign_en": "string",
        "sign_cn": "string",
        "sign_name": "示例名称",
        "sign_font": "string"
      }
    ]
  },
  "planet_second": [
    {
      "sign": {
        "deg": 0,
        "min": 0,
        "sec": 0,
        "sign_id": 0,
        "sign_en": "string",
        "sign_cn": "string",
        "sign_name": "示例名称",
        "sign_font": "string"
      },
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "planet_code": "string",
      "longitude": 0,
      "house_id": 0,
      "speed": 0,
      "planet_font": "string",
      "house_longitude": 0,
      "house_deg": 0,
      "house_min": 0,
      "house_sec": 0
    }
  ],
  "corpus": [
    {
      "chartType": "string",
      "from_cn": "string",
      "to_cn": "string",
      "from_en": "string",
      "to_en": "string",
      "from_name": "示例名称",
      "to_name": "示例名称",
      "type": "string",
      "title": "string",
      "content": "string"
    }
  ],
  "svg": "string",
  "firdaria": {},
  "smalllimit": {},
  "param": {},
  "extra": {}
}

AstroEventVo

object

星象事件信息视图对象

字段定义

chart_typestring非空

星盘类型

asp_typestring非空

星象类型（英文标识）

asp_namestring | null

星象类型名称（多语言）

from_objstring非空

源星体（英文标识）

from_namestring | null

源星体名称（多语言）

to_objstring非空

目标星体（英文标识）

to_namestring | null

目标星体名称（多语言）

event_typeInOutType | null

星象事件类型: In/Out

occurred_atstring非空

时间字符串

示例数据

{
  "chart_type": "string",
  "asp_type": "string",
  "asp_name": "示例名称",
  "from_obj": "string",
  "from_name": "示例名称",
  "to_obj": "string",
  "to_name": "示例名称",
  "event_type": "In",
  "occurred_at": "string"
}

AttributeVo

object

属性信息视图对象

字段定义

firearray<AttributePlanet>

火象星座

soilarray<AttributePlanet>

土象星座

windarray<AttributePlanet>

风象星座

waterarray<AttributePlanet>

水象星座

standardarray<AttributePlanet>

本位星座

fixedarray<AttributePlanet>

固定星座

changearray<AttributePlanet>

变动星座

示例数据

{
  "fire": [
    {
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "planet_code": "string",
      "longitude": 0,
      "house_id": 0,
      "speed": 0,
      "planet_font": "string",
      "deg": 0,
      "min": 0,
      "sec": 0,
      "sign_id": 0,
      "sign_en": "string",
      "sign_cn": "string",
      "sign_name": "示例名称",
      "sign_font": "string"
    }
  ],
  "soil": [
    {
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "planet_code": "string",
      "longitude": 0,
      "house_id": 0,
      "speed": 0,
      "planet_font": "string",
      "deg": 0,
      "min": 0,
      "sec": 0,
      "sign_id": 0,
      "sign_en": "string",
      "sign_cn": "string",
      "sign_name": "示例名称",
      "sign_font": "string"
    }
  ],
  "wind": [
    {
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "planet_code": "string",
      "longitude": 0,
      "house_id": 0,
      "speed": 0,
      "planet_font": "string",
      "deg": 0,
      "min": 0,
      "sec": 0,
      "sign_id": 0,
      "sign_en": "string",
      "sign_cn": "string",
      "sign_name": "示例名称",
      "sign_font": "string"
    }
  ],
  "water": [
    {
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "planet_code": "string",
      "longitude": 0,
      "house_id": 0,
      "speed": 0,
      "planet_font": "string",
      "deg": 0,
      "min": 0,
      "sec": 0,
      "sign_id": 0,
      "sign_en": "string",
      "sign_cn": "string",
      "sign_name": "示例名称",
      "sign_font": "string"
    }
  ],
  "standard": [
    {
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "planet_code": "string",
      "longitude": 0,
      "house_id": 0,
      "speed": 0,
      "planet_font": "string",
      "deg": 0,
      "min": 0,
      "sec": 0,
      "sign_id": 0,
      "sign_en": "string",
      "sign_cn": "string",
      "sign_name": "示例名称",
      "sign_font": "string"
    }
  ],
  "fixed": [
    {
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "planet_code": "string",
      "longitude": 0,
      "house_id": 0,
      "speed": 0,
      "planet_font": "string",
      "deg": 0,
      "min": 0,
      "sec": 0,
      "sign_id": 0,
      "sign_en": "string",
      "sign_cn": "string",
      "sign_name": "示例名称",
      "sign_font": "string"
    }
  ],
  "change": [
    {
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "planet_code": "string",
      "longitude": 0,
      "house_id": 0,
      "speed": 0,
      "planet_font": "string",
      "deg": 0,
      "min": 0,
      "sec": 0,
      "sign_id": 0,
      "sign_en": "string",
      "sign_cn": "string",
      "sign_name": "示例名称",
      "sign_font": "string"
    }
  ]
}

CommentVo

object

运势建议

字段定义

preferstring

运势偏好

默认值: ""

avoidstring

运势避免

默认值: ""

summarystring

运势总结

默认值: ""

示例数据

{
  "prefer": "",
  "avoid": "",
  "summary": ""
}

CorpusVo

object

语料信息视图对象

字段定义

chartTypestring非空

星盘类型

from_cnstring非空

主体对象中文名

to_cnstring非空

客体对象英文名（如：宫位名、星座名、其他行星名）

from_enstring非空

主体对象英文名（如：行星英文名）

to_enstring非空

客体对象英文名（如：行星英文名）

from_namestring非空

主体对象本地化名称，根据请求的lang参数支持不同语言

to_namestring非空

客体对象本地化名称，根据请求的lang参数支持不同语言

typestring非空

语料类型，值为：'PlanetToSign', 'PlanetToHouse', 'PlanetAspect0', 'PlanetAspect60', 'PlanetAspect90', 'PlanetAspect120', 'PlanetAspect180'

asp_angleinteger | null

相位角度（0, 60, 90, 120, 180）

occurred_at_tsinteger | null

星象发生的时间戳

in_outstring | null

入相/出相

start_daysinteger | null

星象开始天数

start_days_descstring | null

星象开始天数文字描述

remain_daysinteger | null

星象还剩多少天

remain_days_descstring | null

星象还剩多少天文字描述

jx_typestring | null

星象吉凶，值为Ji/Xiong/Ping，分别代表吉/凶/平

tipstring | null

小贴士

titlestring非空

星象标题

contentstring非空

语料内容

示例数据

{
  "chartType": "string",
  "from_cn": "string",
  "to_cn": "string",
  "from_en": "string",
  "to_en": "string",
  "from_name": "示例名称",
  "to_name": "示例名称",
  "type": "string",
  "asp_angle": 0,
  "occurred_at_ts": 0,
  "in_out": "string",
  "start_days": 0,
  "start_days_desc": "string",
  "remain_days": 0,
  "remain_days_desc": "string",
  "jx_type": "string",
  "tip": "string",
  "title": "string",
  "content": "string"
}

DailyMoodVo

object

每日心情

字段定义

scope_infoarray<ScopeInfoVo>

各项运势信息

scope_totalScopeTotalVo | null

运势总分

commentCommentVo | null

运势建议（日运特有）

示例数据

{
  "scope_info": [
    {
      "label": "string",
      "icon": "string",
      "color": "string",
      "val": 0,
      "content": "string"
    }
  ],
  "scope_total": {
    "label": "string",
    "val": 0,
    "start_date": "2024-01-01",
    "end_date": "2024-01-01",
    "tips": "string"
  },
  "comment": {
    "prefer": "",
    "avoid": "",
    "summary": ""
  }
}

HouseVo

object

宫位信息视图对象

字段定义

signSignInfo非空

宫头所在星座信息

longitudenumber非空

宫头黄道经度

house_idinteger非空

宫位ID

house_lifestring非空

宫位名称

main_planetarray<MainPlanet>非空

宫主星列表

planet_arrayarray<PlanetArray>非空

宫位内行星列表

示例数据

{
  "sign": {
    "deg": 0,
    "min": 0,
    "sec": 0,
    "sign_id": 0,
    "sign_en": "string",
    "sign_cn": "string",
    "sign_name": "示例名称",
    "sign_font": "string"
  },
  "longitude": 0,
  "house_id": 0,
  "house_life": "string",
  "main_planet": [
    {
      "planet_code": "string",
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "planet_font": "string"
    }
  ],
  "planet_array": [
    {
      "deg": 0,
      "min": 0,
      "sec": 0,
      "longitude": 0,
      "planet_code": "string",
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "planet_font": "string"
    }
  ]
}

JiuGongCellVo

object

单宫。转盘类：di_pan_gan/tian_pan_gan/an_gan/jiu_xing/ba_men/ba_shen/ju；金函：shen_xing、ba_men 为主。

字段定义

luoshuinteger非空

洛书宫数 1~9

baguastring非空

卦名

gongstring非空

宫标识，如坎(1)

wuxingstring非空

宫位本位五行：mu/huo/tu/jin/shui

di_pan_ganarray<string> | null

地盘天干：首项本宫，坤二可有第二项为中五寄干

tian_pan_ganarray<string> | null

巡逻军（天盘奇仪）：与九星同圈飞布；坤二本宫+中五寄干随天芮落宫展示，符落中五时落时干宫

an_ganstring | null

暗干/隐干：旨归=旬内干支；阴盘=时干飞布干+宫支；法窍/鸣法=单天干；括囊用 an_gan_layers

an_gan_layersarray<string> | null

括囊飞盘三暗干支 [天盘, 人盘, 地盘]，天乙/太乙/地乙统领，每项为干+支如庚辰

shen_trailstring | null

九神旁注（飞盘）：地盘九神，同干所带之神

men_trailstring | null

门旁注（括囊暗九门镜像）：明使对冲宫起，序10−明使门序，洛书顺、阳递减/阴递增

jiu_xingstring | null

九星全称；天盘天芮显示为禽芮（禽寄坤二随芮飞）

ba_menstring | null

八门全称（如休门、死门）

ba_shenstring | null

八神（转盘）

ge_juQimenGeJuVo | null

格局：时家=81奇仪同宫；金函=神星遇八门（pattern_type=star_door）

markersarray<QimenPalaceMarkerVo>

宫位标记：空亡、驿马、击刑、门迫、入墓

palace_auxQimenPalaceAuxVo | null

宫位辅助：天盘干、地盘干各含十二长生与月令旺衰

ying_qiQimenYingQiVo | null

应期数池：后天数、先天数、五行数及合并候选；中五无

nei_waistring | null

内外盘：阳遁坎艮震巽为内、离坤兑乾为外，阴遁相反；内主近快、外主远慢；中五无

shen_xingstring | null

神星名（日家金函等）

justring | null

宫内局注记（转盘）

示例数据

{
  "luoshu": 1,
  "bagua": "string",
  "gong": "string",
  "wuxing": "string",
  "di_pan_gan": [
    "string"
  ],
  "tian_pan_gan": [
    "string"
  ],
  "an_gan": "string",
  "an_gan_layers": [
    "string"
  ],
  "shen_trail": "string",
  "men_trail": "string",
  "jiu_xing": "string",
  "ba_men": "string",
  "ba_shen": "string",
  "ge_ju": {
    "name": "示例名称",
    "level": "string",
    "level_cn": "string",
    "title": "string",
    "summary": "string",
    "tags": [
      "string"
    ],
    "scenarios": [
      "string"
    ],
    "desc": "",
    "tian_gan": "",
    "di_gan": "",
    "door_hint": "string",
    "pattern_type": "qiyi",
    "shen_xing": "string",
    "ba_men": "string"
  },
  "markers": [
    {
      "code": "kong_wang",
      "name": "示例名称"
    }
  ],
  "palace_aux": {
    "gan": {
      "tian": {
        "changsheng": "string",
        "wang_shuai": "string"
      },
      "di": {
        "changsheng": "string",
        "wang_shuai": "string"
      }
    }
  },
  "ying_qi": {
    "houtian": 0,
    "xiantian": 0,
    "wuxing": [
      0
    ],
    "pool": [
      0
    ]
  },
  "nei_wai": "string",
  "shen_xing": "string",
  "ju": "string"
}

LiurenChuanVo

object

三传之一。

字段定义

namestring非空

初传 / 中传 / 末传

zhistring非空

传支

gan_zhistring非空

传支（与 zhi 相同；留作兼容）

tian_jiangstring非空

天将

liu_qinstring非空

六亲

kong_wangstring | null

旬空天干；无则 null

shenstring非空

天将（与 tian_jiang 相同，兼容旧字段）

interpretLiurenInterpretVo | null

三传解读

示例数据

{
  "name": "示例名称",
  "zhi": "string",
  "gan_zhi": "string",
  "tian_jiang": "string",
  "liu_qin": "string",
  "kong_wang": "string",
  "shen": "string",
  "interpret": {
    "category": "geju",
    "name": "示例名称",
    "title": "string",
    "summary": "string",
    "tags": [
      "string"
    ],
    "scenarios": [
      "string"
    ],
    "desc": "",
    "level": "string",
    "level_cn": "string",
    "meta_lines": [
      "string"
    ]
  }
}

LiurenGeJuItemVo

object

课体格局项（含解读）。

字段定义

namestring非空

格局名，如遥克、弹射

interpretLiurenInterpretVo | null

格局解读文案

示例数据

{
  "name": "示例名称",
  "interpret": {
    "category": "geju",
    "name": "示例名称",
    "title": "string",
    "summary": "string",
    "tags": [
      "string"
    ],
    "scenarios": [
      "string"
    ],
    "desc": "",
    "level": "string",
    "level_cn": "string",
    "meta_lines": [
      "string"
    ]
  }
}

LiurenInfoVo

object

大六壬排盘简版结果（奇门穿壬时附带）。

字段定义

input_timestring非空

用户输入的查询时间（本地）

true_solar_timestring | null

真太阳时（启用时）

lunarstring非空

农历行，含时辰

typestring非空

术式类型中文

day_gan_zhistring非空

日干支

yue_jiangstring非空

月将地支

shistring非空

占时地支

tian_panobject非空

地盘支 → 天盘支

di_panobject非空

地盘支 → 地盘支（固定序）

si_kearray<LiurenKe>非空

四课

san_chuanarray<LiurenChuan>非空

三传

tian_jiangobject非空

天盘支 → 天将名

示例数据

{
  "input_time": "2024-01-01T00:00:00Z",
  "true_solar_time": "2024-01-01T00:00:00Z",
  "lunar": "string",
  "type": "string",
  "day_gan_zhi": "string",
  "yue_jiang": "string",
  "shi": "string",
  "tian_pan": {},
  "di_pan": {},
  "si_ke": [
    {
      "name": "示例名称",
      "tian": "string",
      "di": "string"
    }
  ],
  "san_chuan": [
    {
      "name": "示例名称",
      "gan_zhi": "string",
      "shen": "string"
    }
  ],
  "tian_jiang": {}
}

LiurenInterpretVo

object

单条解读（课体、四课、三传、宫位等）。

字段定义

categorystring非空

解读类别

namestring非空

键名或展示名

titlestring非空

标题

summarystring非空

一句话摘要

tagsarray<string>

主题标签

scenariosarray<string>

典型情境

descstring

详细说明

默认值: ""

levelstring | null

吉凶层级 key

level_cnstring | null

吉凶中文

meta_linesarray<string>

盘面上下文补充行（如天地组合、用神等）

示例数据

{
  "category": "geju",
  "name": "示例名称",
  "title": "string",
  "summary": "string",
  "tags": [
    "string"
  ],
  "scenarios": [
    "string"
  ],
  "desc": "",
  "level": "string",
  "level_cn": "string",
  "meta_lines": [
    "string"
  ]
}

LiurenKeVo

object

四课之一（大六壬）或金口诀四要素（人元/贵神/将神/地分）。

字段定义

namestring非空

第一课…第四课，或人元/贵神/将神/地分

tianstring非空

上神（天盘支+干）或金口诀干支

distring | null

下神（寄宫支+干），与 tian 下半相同时可省略

tian_jiangstring

上神所临天将；金口诀贵神/将神名

默认值: ""

wu_xingstring | null

金口诀：五行

yin_yangstring | null

金口诀：阴阳

wang_shuaistring | null

金口诀：旺衰

is_yong_shenboolean | null

金口诀：是否用神

na_yinstring | null

金口诀：纳音五行

interpretLiurenInterpretVo | null

四课解读

示例数据

{
  "name": "示例名称",
  "tian": "string",
  "di": "string",
  "tian_jiang": "",
  "wu_xing": "string",
  "yin_yang": "string",
  "wang_shuai": "string",
  "is_yong_shen": true,
  "na_yin": "string",
  "interpret": {
    "category": "geju",
    "name": "示例名称",
    "title": "string",
    "summary": "string",
    "tags": [
      "string"
    ],
    "scenarios": [
      "string"
    ],
    "desc": "",
    "level": "string",
    "level_cn": "string",
    "meta_lines": [
      "string"
    ]
  }
}

LiurenPalaceNoteVo

object

单宫解读（地盘宫位）。

字段定义

earthstring非空

地盘支

skystring非空

天盘支

tian_jiangstring非空

天将名

is_shiboolean

是否为占时支所在宫

默认值: false

is_di_fenboolean

是否为金口诀地分所在宫

默认值: false

interpretLiurenInterpretVo | null

宫位解读文案

示例数据

{
  "earth": "string",
  "sky": "string",
  "tian_jiang": "string",
  "is_shi": false,
  "is_di_fen": false,
  "interpret": {
    "category": "geju",
    "name": "示例名称",
    "title": "string",
    "summary": "string",
    "tags": [
      "string"
    ],
    "scenarios": [
      "string"
    ],
    "desc": "",
    "level": "string",
    "level_cn": "string",
    "meta_lines": [
      "string"
    ]
  }
}

LiurenResultVo

object

大六壬排盘完整结果。

字段定义

input_timestring非空

用户输入的查询时间（本地）

true_solar_timestring | null

真太阳时（启用时）

lunarstring非空

农历行，含时辰

weekday_cnstring | null

星期

typestring非空

术式类型中文，如大六壬

gui_methodstring非空

贵人起法：天贵 / 地贵

di_fenstring | null

金口诀地分地支

solar_termstring非空

排盘时刻节气（天文定气）

jie_qi_prevQimenJieQiItemVo非空

上一节气交节

jie_qi_nextQimenJieQiItemVo非空

下一节气交节

year_pillarQimenPillarVo非空

年柱（干支 + 旬空）

month_pillarQimenPillarVo非空

月柱（干支 + 旬空）

day_pillarQimenPillarVo非空

日柱（干支 + 旬空）

hour_pillarQimenPillarVo非空

时柱（干支 + 旬空）

year_gan_zhistring非空

年干支

month_gan_zhistring非空

月干支

day_gan_zhistring非空

日干支

shi_gan_zhistring非空

时干支

yue_jiangstring非空

月将地支

yue_jiang_namestring非空

月将名，如登明

shistring非空

占时地支

ge_juarray<string>

课体格局，如贼克、元首

ge_ju_detailarray<LiurenGeJuItemVo>

课体格局（含解读文案）

ri_mastring | null

日马地支

tian_panobject非空

地盘支 → 天盘支

di_panobject非空

地盘支 → 地盘支（固定序）

tian_jiangobject非空

天盘支 → 天将名（与盘面天盘同序）

tian_jiang_on_earthobject非空

地盘支 → 天将名

palace_notesobject

地盘支 → 宫位解读

si_kearray<LiurenKeVo>非空

四课

san_chuanarray<LiurenChuanVo>非空

三传

示例数据

{
  "input_time": "2024-01-01T00:00:00Z",
  "true_solar_time": "2024-01-01T00:00:00Z",
  "lunar": "string",
  "weekday_cn": "string",
  "type": "string",
  "gui_method": "string",
  "di_fen": "string",
  "solar_term": "string",
  "jie_qi_prev": {
    "name": "示例名称",
    "jiaojie_local": "string"
  },
  "jie_qi_next": {
    "name": "示例名称",
    "jiaojie_local": "string"
  },
  "year_pillar": {
    "label": "string",
    "kong_wang": "string"
  },
  "month_pillar": {
    "label": "string",
    "kong_wang": "string"
  },
  "day_pillar": {
    "label": "string",
    "kong_wang": "string"
  },
  "hour_pillar": {
    "label": "string",
    "kong_wang": "string"
  },
  "year_gan_zhi": "string",
  "month_gan_zhi": "string",
  "day_gan_zhi": "string",
  "shi_gan_zhi": "string",
  "yue_jiang": "string",
  "yue_jiang_name": "示例名称",
  "shi": "string",
  "ge_ju": [
    "string"
  ],
  "ge_ju_detail": [
    {
      "name": "示例名称"
    }
  ],
  "ri_ma": "string",
  "tian_pan": {},
  "di_pan": {},
  "tian_jiang": {},
  "tian_jiang_on_earth": {},
  "palace_notes": {},
  "si_ke": [
    {
      "name": "示例名称",
      "tian": "string"
    }
  ],
  "san_chuan": [
    {
      "name": "示例名称",
      "zhi": "string",
      "gan_zhi": "string",
      "tian_jiang": "string",
      "liu_qin": "string",
      "shen": "string"
    }
  ]
}

LuckInfoVo

object

幸运信息

字段定义

labelstring非空

标签，如：幸运色/幸运方位/幸运数字等

valstring非空

值

iconstring非空

图标URL

示例数据

{
  "label": "string",
  "val": "string",
  "icon": "string"
}

MySignRespVo

object

我的星座响应数据

字段定义

hidden_skillstring非空

隐藏技能

matched_signsstring非空

匹配的星座

luck_infoarray<LuckInfoVo>

幸运信息列表

scope_preferstring非空

运势偏好

scope_avoidstring非空

运势避免

scope_summarystring非空

运势总结

sign_explainsarray<SignExplainVo>

行星星座解释列表

示例数据

{
  "hidden_skill": "12345",
  "matched_signs": "string",
  "luck_info": [
    {
      "label": "string",
      "val": "string",
      "icon": "string"
    }
  ],
  "scope_prefer": "string",
  "scope_avoid": "12345",
  "scope_summary": "string",
  "sign_explains": [
    {
      "label": "string",
      "pl": "string",
      "sign": "string",
      "tag": "string",
      "tag_img": "string",
      "summary": null
    }
  ]
}

NaksVo

object

星宿关系响应

字段定义

natal_naks_infoNaksInfo非空

本命基本信息

daily_naks_infoNaksInfo非空

值日星宿信息

others_natal_relationarray<NaksRelation>

与其他人本命星宿关系信息

默认值: []

others_daily_relationarray<NaksRelation>

与其他人值日星宿关系信息

默认值: []

natal_interpsarray<Section>

本命星宿解读

默认值: []

daily_interpsarray<Section>

值日星宿解读

默认值: []

analysis_timestring | null

分析时间

示例数据

{
  "natal_naks_info": {
    "idx": 0,
    "name": "示例名称",
    "user_id": "12345",
    "tip": "",
    "brief": ""
  },
  "daily_naks_info": {
    "idx": 0,
    "name": "示例名称",
    "user_id": "12345",
    "tip": "",
    "brief": ""
  },
  "others_natal_relation": [],
  "others_daily_relation": [],
  "natal_interps": [],
  "daily_interps": [],
  "analysis_time": "2024-01-01T00:00:00Z"
}

PlanetVo

object

行星信息视图对象

字段定义

signSignInfo非空

行星所在星座信息

planet_enstring非空

行星英文名

planet_cnstring非空

行星中文名

planet_namestring非空

行星本地化名称，根据请求的lang参数支持不同语言

planet_codestring非空

行星代码

longitudenumber非空

行星黄道经度

house_idinteger非空

行星所在宫位ID

speednumber非空

行星速度

planet_fontstring非空

行星字体

house_longitudenumber非空

宫头黄道经度

house_deginteger非空

宫头度数

house_mininteger非空

宫头分数

house_secinteger非空

宫头秒数

planet_allow_degreearray<PlanetAllowDegree>

相位容许度列表

示例数据

{
  "sign": {
    "deg": 0,
    "min": 0,
    "sec": 0,
    "sign_id": 0,
    "sign_en": "string",
    "sign_cn": "string",
    "sign_name": "示例名称",
    "sign_font": "string"
  },
  "planet_en": "string",
  "planet_cn": "string",
  "planet_name": "示例名称",
  "planet_code": "string",
  "longitude": 0,
  "house_id": 0,
  "speed": 0,
  "planet_font": "string",
  "house_longitude": 0,
  "house_deg": 0,
  "house_min": 0,
  "house_sec": 0,
  "planet_allow_degree": [
    {
      "planet_code": "string",
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "planet_font": "string",
      "current_longitude": 0,
      "asp_angle": 0,
      "in_out": "string",
      "deg": 0,
      "min": 0,
      "sec": 0
    }
  ]
}

QimenDirectionItemVo

object

单宫方位评分明细（include_directions=true 时返回全九宫）。

字段定义

palaceinteger非空

洛书宫数 1~9

baguastring | null

八卦名；中宫（5）为 null

directionstring | null

方位中文（北/南/东/西…）；中宫为 null

doorstring | null

八门名；无门宫为 null

starstring | null

九星名

spiritstring | null

八神名

three_qistring | null

三奇（乙丙丁）所在宫标记，如乙

ge_justring | null

宫位格局名（如有）

scoreinteger非空

方位评分

levelstring非空

吉凶层级：great_auspicious/auspicious/neutral/inauspicious/great_inauspicious

level_cnstring非空

吉凶中文：大吉/吉/平/凶/大凶

reasonsarray<string>

评分理由文本

is_bestboolean

是否为该时辰最吉方位

默认值: false

is_avoidboolean

是否为该时辰忌方位

默认值: false

示例数据

{
  "palace": 0,
  "bagua": "string",
  "direction": "string",
  "door": "string",
  "star": "string",
  "spirit": "string",
  "three_qi": "string",
  "ge_ju": "string",
  "score": 0,
  "level": "string",
  "level_cn": "string",
  "reasons": [
    "string"
  ],
  "is_best": false,
  "is_avoid": false
}

QimenGanAuxVo

object

宫位天盘干、地盘干辅助。

字段定义

tianQimenGanStateVo | null

天盘干（巡逻军本宫干）

diQimenGanStateVo | null

地盘干（本宫干）

示例数据

{
  "tian": {
    "changsheng": "string",
    "wang_shuai": "string"
  },
  "di": {
    "changsheng": "string",
    "wang_shuai": "string"
  }
}

QimenGanStateVo

object

单干在宫内的状态。

字段定义

changshengstring | null

十二长生：长生、沐浴、冠带、临官、帝旺、衰、病、死、墓、绝、胎、养

wang_shuaistring | null

月令旺衰：旺/相/休/囚/死（该干五行相对月支）

示例数据

{
  "changsheng": "string",
  "wang_shuai": "string"
}

QimenGeJuVo

object

单宫格局：时家为奇仪同宫；金函为神星遇八门。

字段定义

namestring非空

经典格局名，如青龙返首、青龙临开

levelstring非空

吉凶层级：great_auspicious/auspicious/neutral/inauspicious/great_inauspicious

level_cnstring非空

吉凶中文：大吉/吉/平/凶/大凶

titlestring非空

展示标题

summarystring非空

一句话摘要

tagsarray<string>

主题标签

scenariosarray<string>

常见生活场景

descstring

详细说明

默认值: ""

tian_ganstring

天盘干（时家奇仪格）；金函神星格为空

默认值: ""

di_ganstring

地盘干（时家奇仪格）；金函神星格为空

默认值: ""

door_hintstring | null

结合八门的简要提示（门吉则吉、门凶则凶）

pattern_typestring

qiyi=时家81奇仪格 | star_door=金函神星遇八门

默认值: "qiyi"

shen_xingstring | null

金函神星（pattern_type=star_door 时）

ba_menstring | null

金函八门（pattern_type=star_door 时）

示例数据

{
  "name": "示例名称",
  "level": "string",
  "level_cn": "string",
  "title": "string",
  "summary": "string",
  "tags": [
    "string"
  ],
  "scenarios": [
    "string"
  ],
  "desc": "",
  "tian_gan": "",
  "di_gan": "",
  "door_hint": "string",
  "pattern_type": "qiyi",
  "shen_xing": "string",
  "ba_men": "string"
}

QimenHuangHeiDaoHourVo

object

单时辰黄黑道值日神。

字段定义

hour_branchstring非空

时辰地支，如子、丑

hour_labelstring非空

时辰展示，如子时

god_codestring非空

值日神稳定标识，如 qing_long

god_namestring非空

值日神名，如青龙

dao_typestring非空

huang=黄道（吉）| hei=黑道（凶）

auspiciousboolean非空

是否黄道吉时

briefstring | null

一行提示

示例数据

{
  "hour_branch": "string",
  "hour_label": "string",
  "god_code": "string",
  "god_name": "示例名称",
  "dao_type": "huang",
  "auspicious": true,
  "brief": "string"
}

QimenJieQiItemVo

object

节气交节信息（名称 + 本地时间）

字段定义

namestring非空

节气名

jiaojie_localstring非空

交节本地时间 YYYY-MM-DD HH:MM:SS

示例数据

{
  "name": "示例名称",
  "jiaojie_local": "string"
}

QimenPaiFaVo

object

排法摘要（结构化 + 可读串）

字段定义

digeststring非空

一行排法摘要，便于列表展示

qiju_typestring非空

起局类型中文，如时家、日家

ju_methodstring | null

定局法中文，如拆补、金函；山向等无定局法时为 null

pai_methodstring非空

排盘方式中文，如转盘

ju_lineagestring | null

流派/子类展示，如日家「金函玉镜（太乙日家）」

示例数据

{
  "digest": "string",
  "qiju_type": "string",
  "ju_method": "string",
  "pai_method": "string",
  "ju_lineage": "string"
}

QimenPalaceAuxVo

object

单宫天干辅助信息。

字段定义

ganQimenGanAuxVo | null

天盘干、地盘干辅助信息

示例数据

{
  "gan": {
    "tian": {
      "changsheng": "string",
      "wang_shuai": "string"
    },
    "di": {
      "changsheng": "string",
      "wang_shuai": "string"
    }
  }
}

QimenPalaceMarkerVo

object

单宫标记。

字段定义

codestring非空

namestring非空

展示名，如空亡

briefstring | null

一行提示

示例数据

{
  "code": "kong_wang",
  "name": "示例名称",
  "brief": "string"
}

QimenPillarVo

object

单柱展示：干支带单位 + 旬空（与奇门大师等前端约定一致）。

字段定义

labelstring非空

干支与单位，如丙午年、庚寅月

kong_wangstring非空

该柱旬空两地支连写，如寅卯；无则空串

示例数据

{
  "label": "string",
  "kong_wang": "string"
}

QimenResultVo

object

奇门排盘结果：转盘类与金函日家共用本模型，金函不用的字段为 null。

字段定义

input_timestring非空

用户输入的查询时间（本地）

true_solar_timestring | null

真太阳时（启用时）

lunarstring非空

农历行，含时辰

weekday_cnstring | null

星期

pai_faQimenPaiFaVo非空

排法摘要（起局类型、定局法、排盘方式等）

typestring非空

起局类型中文简写

ju_methodstring | null

定局法；山向等无定局法时为 null

pai_methodstring非空

排盘方式

jie_qi_prevQimenJieQiItemVo非空

上一节气交节（相对查询时刻，本地时间）

jie_qi_nextQimenJieQiItemVo非空

下一节气交节（本地时间）

year_pillarQimenPillarVo非空

年柱（干支 + 旬空）

month_pillarQimenPillarVo非空

月柱（干支 + 旬空）

day_pillarQimenPillarVo非空

日柱（干支 + 旬空）

genderstring | null

性别

locationstring | null

地点

nian_mingstring | null

年命

liuren_dataobject | null

奇门穿壬时附六壬简数据

year_gan_zhistring非空

年干支

month_gan_zhistring非空

月干支

day_gan_zhistring非空

日干支

pan_variantstring非空

shan_xiangQimenShanXiangVo | null

山向奇门专用：坐向、分金区间与等效日时；非山向为 null

yin_yangstring非空

阴阳遁：yang=阳遁，yin=阴遁

ju_displaystring非空

局名展示，如阳4局或金函简注

solar_termstring非空

排盘时刻太阳黄经定气（天文节气，与 jie_qi_prev/next 一致）

ding_ju_termstring | null

定局查表节气；置闰接气/超神时可能与 solar_term 不同；金函日家无传统定局表时为 null

ju_numinteger | null

局数 1~9；金函为 null

yuanstring | null

三元；金函为 null

hour_pillarQimenPillarVo | null

时柱；日家（传统/金函）为 null，时辰见 lunar

xun_shoustring | null

旬首展示；金函为 null

zhi_fustring | null

值符星简称（旬首宫地盘本位星，飞出前的星）；金函为 null

zhi_shistring | null

值使门简称；金函为 null

tian_yistring | null

天乙：值符飞落宫的地盘固定九星简称（如时干落坎一则蓬）；与 zhi_fu 旬首本位星可不同；非日干贵人

special_patternsarray<QimenSpecialPatternVo>

特殊标记：天显、伏吟、反吟、五不遇时、日干入墓等

jiu_gongobject非空

九宫，key 为洛书数 "1".."9"

huang_hei_daoarray<QimenHuangHeiDaoHourVo> | null

十二黄黑道（金函日家）：子丑…亥各时辰值日神；时家/传统日盘为 null

shi_gan_zhistring | null

时干支；日家（传统/金函）为 null，时辰见 lunar

示例数据

{
  "input_time": "2024-01-01T00:00:00Z",
  "true_solar_time": "2024-01-01T00:00:00Z",
  "lunar": "string",
  "weekday_cn": "string",
  "pai_fa": {
    "digest": "string",
    "qiju_type": "string",
    "ju_method": "string",
    "pai_method": "string",
    "ju_lineage": "string"
  },
  "type": "string",
  "ju_method": "string",
  "pai_method": "string",
  "jie_qi_prev": {
    "name": "示例名称",
    "jiaojie_local": "string"
  },
  "jie_qi_next": {
    "name": "示例名称",
    "jiaojie_local": "string"
  },
  "year_pillar": {
    "label": "string",
    "kong_wang": "string"
  },
  "month_pillar": {
    "label": "string",
    "kong_wang": "string"
  },
  "day_pillar": {
    "label": "string",
    "kong_wang": "string"
  },
  "gender": "string",
  "location": "string",
  "nian_ming": "string",
  "liuren_data": {},
  "year_gan_zhi": "string",
  "month_gan_zhi": "string",
  "day_gan_zhi": "string",
  "pan_variant": "shijia_chaibu",
  "shan_xiang": {
    "shan_mount": "string",
    "xiang_mount": "string",
    "yuan": "shang",
    "yuan_label": "string",
    "event_year": 0,
    "equivalent_day": "string",
    "equivalent_hour": "string"
  },
  "yin_yang": "yang",
  "ju_display": "string",
  "solar_term": "string",
  "ding_ju_term": "string",
  "ju_num": 1,
  "yuan": "string",
  "hour_pillar": {
    "label": "string",
    "kong_wang": "string"
  },
  "xun_shou": "string",
  "zhi_fu": "string",
  "zhi_shi": "string",
  "tian_yi": "string",
  "special_patterns": [
    {
      "code": "string",
      "name": "示例名称",
      "category": "timing"
    }
  ],
  "jiu_gong": {},
  "huang_hei_dao": [
    {
      "hour_branch": "string",
      "hour_label": "string",
      "god_code": "string",
      "god_name": "示例名称",
      "dao_type": "huang",
      "auspicious": true
    }
  ],
  "shi_gan_zhi": "string"
}

QimenSelectBestVo

object

最佳/最凶时辰快捷字段。

字段定义

dtstring非空

时辰起点时间 YYYY-MM-DD HH:MM:SS

hour_labelstring非空

时辰中文标签，如子时

scoreinteger非空

总分

levelstring非空

吉凶层级

level_cnstring非空

吉凶中文

示例数据

{
  "dt": "string",
  "hour_label": "string",
  "score": 0,
  "level": "string",
  "level_cn": "string"
}

QimenSelectHourVo

object

单时辰评分结果。

字段定义

dtstring非空

时辰起点时间 YYYY-MM-DD HH:MM:SS（本地，真太阳时校正后）

hour_labelstring非空

时辰中文标签，如子时

day_pillarstring非空

日柱干支，如甲子

hour_pillarstring非空

时柱干支，如甲子

zhi_shi_menstring非空

值使门名

zhi_fu_starstring非空

值符星名

huang_hei_daostring | null

黄黑道神名（青龙/明堂…）；无则 null

scoreinteger非空

时辰吉凶总分

levelstring非空

吉凶层级：great_auspicious/auspicious/neutral/inauspicious/great_inauspicious

level_cnstring非空

吉凶中文：大吉/吉/平/凶/大凶

reasonsarray<string>

评分理由文本

special_patternsarray<QimenSpecialPatternVo>

特殊标记：天显时格/五不遇时/伏吟/反吟/日干入墓等

is_currentboolean

是否为当前查询时刻所在时辰

默认值: false

best_directionstring | null

该时辰最吉方位中文（如北）

avoid_directionstring | null

该时辰忌方位中文（如西南）

directionsarray<QimenDirectionItemVo> | null

九宫方位全明细；include_directions=true 时返回

示例数据

{
  "dt": "string",
  "hour_label": "string",
  "day_pillar": "string",
  "hour_pillar": "string",
  "zhi_shi_men": "string",
  "zhi_fu_star": "string",
  "huang_hei_dao": "string",
  "score": 0,
  "level": "string",
  "level_cn": "string",
  "reasons": [
    "string"
  ],
  "special_patterns": [
    {
      "code": "string",
      "name": "示例名称",
      "category": "timing"
    }
  ],
  "is_current": false,
  "best_direction": "string",
  "avoid_direction": "12345",
  "directions": [
    {
      "palace": 0,
      "score": 0,
      "level": "string",
      "level_cn": "string"
    }
  ]
}

QimenSelectResultVo

object

奇门择吉结果：best/avoid Top3 快捷 + 按时辰分数降序的全量列表。

字段定义

qry_dtstring非空

查询时间（本地）

daysinteger非空

评分天数

matterstring | null

用事 code（如 travel）；未传为 null

bestarray<QimenSelectBestVo>

最吉时辰 Top3（按分数降序，best[0] 为第一吉）

avoidarray<QimenSelectBestVo>

最凶时辰 Top3（最凶在前，avoid[0] 为第一忌）

hoursarray<QimenSelectHourVo>非空

各时辰评分，按分数降序

示例数据

{
  "qry_dt": "string",
  "days": 0,
  "matter": "string",
  "best": [
    {
      "dt": "string",
      "hour_label": "string",
      "score": 0,
      "level": "string",
      "level_cn": "string"
    }
  ],
  "avoid": [
    {
      "dt": "string",
      "hour_label": "string",
      "score": 0,
      "level": "string",
      "level_cn": "string"
    }
  ],
  "hours": [
    {
      "dt": "string",
      "hour_label": "string",
      "day_pillar": "string",
      "hour_pillar": "string",
      "zhi_shi_men": "string",
      "zhi_fu_star": "string",
      "score": 0,
      "level": "string",
      "level_cn": "string"
    }
  ]
}

QimenShanXiangVo

object

山向定局与等效日时摘要。

字段定义

shan_mountstring非空

坐山英文 code，如 gui（癸山）

xiang_mountstring非空

向山英文 code，如 ding（丁向）

yuanstring非空

shang | zhong | xia

yuan_labelstring非空

上元 / 中元 / 下元

event_yearinteger非空

用事年（来自 qry_dt）

equivalent_daystring非空

等效日柱（年干支），如丙戌

equivalent_hourstring非空

等效时柱（五鼠遁），如甲午

示例数据

{
  "shan_mount": "string",
  "xiang_mount": "string",
  "yuan": "shang",
  "yuan_label": "string",
  "event_year": 0,
  "equivalent_day": "string",
  "equivalent_hour": "string"
}

QimenSpecialPatternVo

object

特殊标记：稳定 code + 展示名 + 分类 + 一行提示。

字段定义

codestring非空

稳定标识，如 fu_yin、tian_xian_shi

namestring非空

展示名，如干伏吟

categorystring非空

timing=时辰禁忌 sizhu=四柱 gan/xing/men=单盘层 pan=全盘

briefstring | null

一行断语或提示

示例数据

{
  "code": "string",
  "name": "示例名称",
  "category": "timing",
  "brief": "string"
}

QimenYingQiVo

object

单宫应期数池（用神/值使/时干落宫时从此池按旺衰取数）。

字段定义

houtianinteger非空

后天八卦数（洛书宫数，取数优先）

xiantianinteger | null

先天八卦数

wuxingarray<integer>非空

五行数（河图生数/成数）

poolarray<integer>非空

应期候选数池：后天→先天→五行，去重保序（pool[0] 为优先后天数）

示例数据

{
  "houtian": 0,
  "xiantian": 0,
  "wuxing": [
    0
  ],
  "pool": [
    0
  ]
}

QizhengAspectVo

object

两星会合关系（合/三合/冲）。

字段定义

from_starQizhengStarKey非空

起算星 key；展示名查 stars[].label

to_starQizhengStarKey非空

目标星 key；展示名查 stars[].label

typeQizhengAspectType非空

合 / 三合 / 冲 key

type_labelstring

关系展示名

默认值: ""

anglenumber非空

实际黄经差 0–180

orbnumber非空

距精确相位的偏差（度）

示例数据

{
  "from_star": "sun",
  "to_star": "sun",
  "type": "conjunct",
  "type_label": "",
  "angle": 0,
  "orb": 0
}

QizhengBasicVo

object

基础 tab：四柱、农历、节气、恩用仇难、安身、童限时长。

立命展示拼顶层 ming（命度）+ palaces[0]（命宫支），本块不重复。

字段定义

pillarsQizhengPillarsVo非空

四柱

lunar_datestring

农历完整串（含时辰）

默认值: ""

is_dayboolean非空

是否昼生（时支卯–申）

day_night_labelstring

昼 / 夜

默认值: ""

jie_qiarray<QizhengJieQiVo>

出生前后节气交节（通常上一、下一、再下一，共 3 项）

graceQizhengGraceVo非空

恩用仇难（度/宫双行）

shenQizhengShenDegreeVo非空

安身（太阴）

tong_xian_spanQizhengTongXianSpanVo非空

童限时长与出限日

示例数据

{
  "pillars": {
    "year": {
      "stem": "string",
      "branch": "string",
      "stem_label": "",
      "branch_label": "",
      "gan_zhi": ""
    },
    "month": {
      "stem": "string",
      "branch": "string",
      "stem_label": "",
      "branch_label": "",
      "gan_zhi": ""
    },
    "day": {
      "stem": "string",
      "branch": "string",
      "stem_label": "",
      "branch_label": "",
      "gan_zhi": ""
    },
    "hour": {
      "stem": "string",
      "branch": "string",
      "stem_label": "",
      "branch_label": "",
      "gan_zhi": ""
    }
  },
  "lunar_date": "",
  "is_day": true,
  "day_night_label": "",
  "jie_qi": [
    {
      "name": "示例名称",
      "at": "string"
    }
  ],
  "grace": {
    "degree": {
      "self_wx": "wood",
      "self_wx_label": "",
      "grace": "wood",
      "grace_label": "",
      "useful": "wood",
      "useful_label": "",
      "foe": "wood",
      "foe_label": "",
      "hardship": "wood",
      "hardship_label": ""
    },
    "palace": {
      "self_wx": "wood",
      "self_wx_label": "",
      "grace": "wood",
      "grace_label": "",
      "useful": "wood",
      "useful_label": "",
      "foe": "wood",
      "foe_label": "",
      "hardship": "wood",
      "hardship_label": ""
    }
  },
  "shen": {
    "palace_degree": 0,
    "xiu": "jiao",
    "xiu_label": "",
    "xiu_degree": 0,
    "earthly_branch": "zi",
    "earthly_branch_label": ""
  },
  "tong_xian_span": {
    "years": 0,
    "months": 0,
    "days": 0,
    "exit_date": "2024-01-01",
    "label": ""
  }
}

QizhengChartVo

object

本命 + 行运。

字段定义

genderstring非空

male / female；展示文案由前端映射

birth_dtstring非空

出生时间 YYYY-MM-DD HH:MM:SS

solar_dtstring非空

真太阳时 YYYY-MM-DD HH:MM:SS；未开则为 birth_dt

basicQizhengBasicVo非空

基础 tab：四柱/农历/节气/恩用/安身/童限时长

mingQizhengMingDegreeVo非空

命度（盘心）；命宫地支见 palaces[0]

starsarray<QizhengStarVo>非空

十一曜本命位置

palacesarray<QizhengPalaceVo>非空

十二宫，index 0–11

xiu_spansarray<QizhengXiuSpanVo>

二十八宿尺（随 xiu_ruler；默认今宿），供圆盘画宿圈

hua_yao_groupsarray<QizhengHuaYaoGroupVo>

化曜看板，按列分组（天禄…天权，含天嗣）。按星耀：列从右往左、行=primary→ten_god→tags；按星体：把各组项按 natal_star/flow_star 聚合。附属归属按 Moira 表序，不由落星决定。

aspectsarray<QizhengAspectVo>

本命合/冲/三合，供圆盘连线

patternsarray<QizhengPatternVo>

主流喜忌格（名称+吉凶）；前端按 type 分栏

dongwei_segmentsarray<QizhengDongweiSegmentVo>

洞微百六大限按宫段落（年龄/公历年），供圆盘最外圈；行限序

readingQizhengReadingVo | null

盘面解读 tab（总纲+要点；与基础/化曜/格局平级）；文案见 qizheng_reading.yaml

target_dtstring非空

行运参照时刻

flow_year_stemstring

流年天干 key（随 target_dt）

默认值: ""

flow_year_branchstring

流年地支 key（随 target_dt）

默认值: ""

flow_starsarray<QizhengStarVo>

流十一曜（target_dt 时刻）

flow_aspectsarray<QizhengAspectVo>

流盘会合关系（流星彼此）

current_limitsQizhengCurrentLimitsVo | null

当前诸限摘要

limit_yearsarray<QizhengLimitYearVo>

按虚岁展开的小限/飞限/童限表

示例数据

{
  "gender": "string",
  "birth_dt": "string",
  "solar_dt": "string",
  "basic": {
    "pillars": {
      "year": {
        "stem": "string",
        "branch": "string",
        "stem_label": "",
        "branch_label": "",
        "gan_zhi": ""
      },
      "month": {
        "stem": "string",
        "branch": "string",
        "stem_label": "",
        "branch_label": "",
        "gan_zhi": ""
      },
      "day": {
        "stem": "string",
        "branch": "string",
        "stem_label": "",
        "branch_label": "",
        "gan_zhi": ""
      },
      "hour": {
        "stem": "string",
        "branch": "string",
        "stem_label": "",
        "branch_label": "",
        "gan_zhi": ""
      }
    },
    "lunar_date": "",
    "is_day": true,
    "day_night_label": "",
    "jie_qi": [
      {
        "name": "示例名称",
        "at": "string"
      }
    ],
    "grace": {
      "degree": {
        "self_wx": "wood",
        "self_wx_label": "",
        "grace": "wood",
        "grace_label": "",
        "useful": "wood",
        "useful_label": "",
        "foe": "wood",
        "foe_label": "",
        "hardship": "wood",
        "hardship_label": ""
      },
      "palace": {
        "self_wx": "wood",
        "self_wx_label": "",
        "grace": "wood",
        "grace_label": "",
        "useful": "wood",
        "useful_label": "",
        "foe": "wood",
        "foe_label": "",
        "hardship": "wood",
        "hardship_label": ""
      }
    },
    "shen": {
      "palace_degree": 0,
      "xiu": "jiao",
      "xiu_label": "",
      "xiu_degree": 0,
      "earthly_branch": "zi",
      "earthly_branch_label": ""
    },
    "tong_xian_span": {
      "years": 0,
      "months": 0,
      "days": 0,
      "exit_date": "2024-01-01",
      "label": ""
    }
  },
  "ming": {
    "palace_degree": 0,
    "xiu": "jiao",
    "xiu_label": "",
    "xiu_degree": 0,
    "lord": "wood",
    "lord_label": "",
    "lord_type_label": ""
  },
  "stars": [
    {
      "key": "sun",
      "longitude": 0,
      "speed": 0,
      "palace_degree": 0,
      "xiu_degree": {
        "xiu": "jiao",
        "degree": 0
      },
      "palace_index": 0
    }
  ],
  "palaces": [
    {
      "index": 0,
      "key": "ming",
      "earthly_branch": "zi"
    }
  ],
  "xiu_spans": [
    {
      "xiu": "jiao",
      "longitude_start": 0,
      "longitude_end": 0,
      "lord": "wood"
    }
  ],
  "hua_yao_groups": [
    {
      "primary": {
        "key": "string",
        "natal_star": "sun"
      }
    }
  ],
  "aspects": [
    {
      "from_star": "sun",
      "to_star": "sun",
      "type": "conjunct",
      "angle": 0,
      "orb": 0
    }
  ],
  "patterns": [
    {
      "key": "string",
      "type": "lucky"
    }
  ],
  "dongwei_segments": [
    {
      "sequence": 0,
      "palace_index": 0,
      "palace_key": "ming",
      "earthly_branch": "zi",
      "span_years": 0,
      "start_age": 0,
      "end_age": 0,
      "start_year": 0,
      "end_year": 0
    }
  ],
  "reading": {
    "summary": "",
    "highlights": [
      {
        "kind": "string",
        "key": "string"
      }
    ],
    "timing": {
      "title": "",
      "body": "",
      "items": [
        {
          "kind": "string",
          "key": "string"
        }
      ]
    },
    "relation": {
      "title": "",
      "body": "",
      "items": [
        {
          "kind": "string",
          "key": "string"
        }
      ]
    }
  },
  "target_dt": "string",
  "flow_year_stem": "",
  "flow_year_branch": "",
  "flow_stars": [
    {
      "key": "sun",
      "longitude": 0,
      "speed": 0,
      "palace_degree": 0,
      "xiu_degree": {
        "xiu": "jiao",
        "degree": 0
      },
      "palace_index": 0
    }
  ],
  "flow_aspects": [
    {
      "from_star": "sun",
      "to_star": "sun",
      "type": "conjunct",
      "angle": 0,
      "orb": 0
    }
  ],
  "current_limits": {
    "xiao_xian": "zi",
    "xiao_xian_label": "",
    "yue_xian": "zi",
    "yue_xian_label": "",
    "fei_xian": "zi",
    "fei_xian_label": "",
    "tong_xian": "zi",
    "tong_xian_label": "",
    "da_xian_palace": "ming",
    "da_xian_palace_label": "",
    "da_xian_start_age": 0,
    "da_xian_end_age": 0,
    "chan_ri": "wood",
    "chan_ri_label": "",
    "ding_du": {
      "longitude": 0,
      "earthly_branch": "zi",
      "earthly_branch_label": "",
      "palace_degree": 0,
      "xiu": "jiao",
      "xiu_label": "",
      "xiu_degree": 0,
      "lord": "wood",
      "lord_label": ""
    }
  },
  "limit_years": [
    {
      "age": 1,
      "year": 0,
      "xiao_xian": "zi",
      "fei_xian": "zi"
    }
  ]
}

QizhengComparisonVo

object

比较盘（与 ChartVo 同构扁平）：A 本命壳 + 外圈复用 flow_*。

stars / palaces[].spirit_stars = A
flow_stars = B 十一曜（落 A 宫）
flow_aspects = A↔B 合/冲/三合（from=A，to=B）
palaces[].flow_spirit_stars = B 本命神煞（按 A 宫支）
无诸限；解读另附 reading.relation

字段定义

genderstring非空

male / female；展示文案由前端映射

birth_dtstring非空

出生时间 YYYY-MM-DD HH:MM:SS

solar_dtstring非空

真太阳时 YYYY-MM-DD HH:MM:SS；未开则为 birth_dt

basicQizhengBasicVo非空

基础 tab：四柱/农历/节气/恩用/安身/童限时长

mingQizhengMingDegreeVo非空

命度（盘心）；命宫地支见 palaces[0]

starsarray<QizhengStarVo>非空

十一曜本命位置

palacesarray<QizhengPalaceVo>非空

十二宫，index 0–11

xiu_spansarray<QizhengXiuSpanVo>

二十八宿尺（随 xiu_ruler；默认今宿），供圆盘画宿圈

hua_yao_groupsarray<QizhengHuaYaoGroupVo>

aspectsarray<QizhengAspectVo>

本命合/冲/三合，供圆盘连线

patternsarray<QizhengPatternVo>

主流喜忌格（名称+吉凶）；前端按 type 分栏

dongwei_segmentsarray<QizhengDongweiSegmentVo>

洞微百六大限按宫段落（年龄/公历年），供圆盘最外圈；行限序

readingQizhengReadingVo | null

盘面解读 tab（总纲+要点；与基础/化曜/格局平级）；文案见 qizheng_reading.yaml

other_genderstring非空

B 性别

other_birth_dtstring非空

B 出生地方时

other_solar_dtstring非空

B 排盘用时刻（真太阳时后）

other_mingQizhengMingDegreeVo非空

B 自身命度（对照用，不改 A 盘心）

flow_starsarray<QizhengStarVo>

B 十一曜；palace_index 相对 A 十二宫；宿度落在 A 的今宿尺上

flow_aspectsarray<QizhengAspectVo>

A↔B 合/冲/三合（from_star=A，to_star=B；可同 key）

示例数据

{
  "gender": "string",
  "birth_dt": "string",
  "solar_dt": "string",
  "basic": {
    "pillars": {
      "year": {
        "stem": "string",
        "branch": "string",
        "stem_label": "",
        "branch_label": "",
        "gan_zhi": ""
      },
      "month": {
        "stem": "string",
        "branch": "string",
        "stem_label": "",
        "branch_label": "",
        "gan_zhi": ""
      },
      "day": {
        "stem": "string",
        "branch": "string",
        "stem_label": "",
        "branch_label": "",
        "gan_zhi": ""
      },
      "hour": {
        "stem": "string",
        "branch": "string",
        "stem_label": "",
        "branch_label": "",
        "gan_zhi": ""
      }
    },
    "lunar_date": "",
    "is_day": true,
    "day_night_label": "",
    "jie_qi": [
      {
        "name": "示例名称",
        "at": "string"
      }
    ],
    "grace": {
      "degree": {
        "self_wx": "wood",
        "self_wx_label": "",
        "grace": "wood",
        "grace_label": "",
        "useful": "wood",
        "useful_label": "",
        "foe": "wood",
        "foe_label": "",
        "hardship": "wood",
        "hardship_label": ""
      },
      "palace": {
        "self_wx": "wood",
        "self_wx_label": "",
        "grace": "wood",
        "grace_label": "",
        "useful": "wood",
        "useful_label": "",
        "foe": "wood",
        "foe_label": "",
        "hardship": "wood",
        "hardship_label": ""
      }
    },
    "shen": {
      "palace_degree": 0,
      "xiu": "jiao",
      "xiu_label": "",
      "xiu_degree": 0,
      "earthly_branch": "zi",
      "earthly_branch_label": ""
    },
    "tong_xian_span": {
      "years": 0,
      "months": 0,
      "days": 0,
      "exit_date": "2024-01-01",
      "label": ""
    }
  },
  "ming": {
    "palace_degree": 0,
    "xiu": "jiao",
    "xiu_label": "",
    "xiu_degree": 0,
    "lord": "wood",
    "lord_label": "",
    "lord_type_label": ""
  },
  "stars": [
    {
      "key": "sun",
      "longitude": 0,
      "speed": 0,
      "palace_degree": 0,
      "xiu_degree": {
        "xiu": "jiao",
        "degree": 0
      },
      "palace_index": 0
    }
  ],
  "palaces": [
    {
      "index": 0,
      "key": "ming",
      "earthly_branch": "zi"
    }
  ],
  "xiu_spans": [
    {
      "xiu": "jiao",
      "longitude_start": 0,
      "longitude_end": 0,
      "lord": "wood"
    }
  ],
  "hua_yao_groups": [
    {
      "primary": {
        "key": "string",
        "natal_star": "sun"
      }
    }
  ],
  "aspects": [
    {
      "from_star": "sun",
      "to_star": "sun",
      "type": "conjunct",
      "angle": 0,
      "orb": 0
    }
  ],
  "patterns": [
    {
      "key": "string",
      "type": "lucky"
    }
  ],
  "dongwei_segments": [
    {
      "sequence": 0,
      "palace_index": 0,
      "palace_key": "ming",
      "earthly_branch": "zi",
      "span_years": 0,
      "start_age": 0,
      "end_age": 0,
      "start_year": 0,
      "end_year": 0
    }
  ],
  "reading": {
    "summary": "",
    "highlights": [
      {
        "kind": "string",
        "key": "string"
      }
    ],
    "timing": {
      "title": "",
      "body": "",
      "items": [
        {
          "kind": "string",
          "key": "string"
        }
      ]
    },
    "relation": {
      "title": "",
      "body": "",
      "items": [
        {
          "kind": "string",
          "key": "string"
        }
      ]
    }
  },
  "other_gender": "string",
  "other_birth_dt": "string",
  "other_solar_dt": "string",
  "other_ming": {
    "palace_degree": 0,
    "xiu": "jiao",
    "xiu_label": "",
    "xiu_degree": 0,
    "lord": "wood",
    "lord_label": "",
    "lord_type_label": ""
  },
  "flow_stars": [
    {
      "key": "sun",
      "longitude": 0,
      "speed": 0,
      "palace_degree": 0,
      "xiu_degree": {
        "xiu": "jiao",
        "degree": 0
      },
      "palace_index": 0
    }
  ],
  "flow_aspects": [
    {
      "from_star": "sun",
      "to_star": "sun",
      "type": "conjunct",
      "angle": 0,
      "orb": 0
    }
  ]
}

QizhengCurrentLimitsVo

object

指定时刻的诸限摘要（行运侧栏）。

字段定义

xiao_xianQizhengEarthlyBranch非空

小限地支 key

xiao_xian_labelstring

小限地支展示

默认值: ""

yue_xianQizhengEarthlyBranch非空

月限地支 key

yue_xian_labelstring

月限地支展示

默认值: ""

fei_xianQizhengEarthlyBranch非空

飞限地支 key

fei_xian_labelstring

飞限地支展示

默认值: ""

tong_xianQizhengEarthlyBranch | null

童限地支 key；幼年后可空

tong_xian_labelstring

童限地支展示

默认值: ""

da_xian_palaceQizhengPalaceKey非空

当前洞微大限所在宫 key

da_xian_palace_labelstring

大限宫展示名

默认值: ""

da_xian_start_ageinteger非空

当前大限起始虚岁

da_xian_end_ageinteger非空

当前大限截止虚岁

chan_riQizhengXiuLord非空

躔日：本命命度主 key

chan_ri_labelstring

躔日展示，如月

默认值: ""

ding_duQizhengDingDuVo非空

顶度（大限圈落点）

示例数据

{
  "xiao_xian": "zi",
  "xiao_xian_label": "",
  "yue_xian": "zi",
  "yue_xian_label": "",
  "fei_xian": "zi",
  "fei_xian_label": "",
  "tong_xian": "zi",
  "tong_xian_label": "",
  "da_xian_palace": "ming",
  "da_xian_palace_label": "",
  "da_xian_start_age": 0,
  "da_xian_end_age": 0,
  "chan_ri": "wood",
  "chan_ri_label": "",
  "ding_du": {
    "longitude": 0,
    "earthly_branch": "zi",
    "earthly_branch_label": "",
    "palace_degree": 0,
    "xiu": "jiao",
    "xiu_label": "",
    "xiu_degree": 0,
    "lord": "wood",
    "lord_label": ""
  }
}

QizhengDingDuVo

object

顶度：查询日在洞微大限圈上的落点（对齐 Moira 年限条）。

字段定义

longitudenumber非空

顶度黄经

earthly_branchQizhengEarthlyBranch非空

顶度宫支 key

earthly_branch_labelstring

顶度宫支展示

默认值: ""

palace_degreenumber非空

顶度宫内度

xiuQizhengXiuKey非空

顶度宿 key

xiu_labelstring

顶度宿名

默认值: ""

xiu_degreenumber非空

顶度宿内度

lordQizhengXiuLord非空

顶度宿度主 key

lord_labelstring

顶度宿度主展示

默认值: ""

示例数据

{
  "longitude": 0,
  "earthly_branch": "zi",
  "earthly_branch_label": "",
  "palace_degree": 0,
  "xiu": "jiao",
  "xiu_label": "",
  "xiu_degree": 0,
  "lord": "wood",
  "lord_label": ""
}

QizhengDongweiSegmentVo

object

洞微百六一段：圆盘最外圈年龄/年份按宫区间。

虚岁为半开区间 [start_age, end_age)；公历年覆盖该段内有效虚岁对应之年。
行限自命宫起沿地支顺行（命→相貌→福德→官禄…），sequence 即该序。

字段定义

sequenceinteger非空

行限序，0=命宫大限段

palace_indexinteger非空

十二宫偏移，0=命宫

palace_keyQizhengPalaceKey非空

宫名 key；展示名查 palaces[].name

earthly_branchQizhengEarthlyBranch非空

宫支 key；展示名查 palaces[].earthly_branch_label

span_yearsnumber非空

本宫管年；可含 4.5

start_agenumber非空

起始虚岁（含）

end_agenumber非空

截止虚岁（不含）；下一段 start_age

start_yearinteger非空

起始公历年

end_yearinteger非空

截止公历年（段内最后一虚岁年）

示例数据

{
  "sequence": 0,
  "palace_index": 0,
  "palace_key": "ming",
  "earthly_branch": "zi",
  "span_years": 0,
  "start_age": 0,
  "end_age": 0,
  "start_year": 0,
  "end_year": 0
}

QizhengGraceRowVo

object

一行恩用仇难（度主或宫主）。

字段定义

self_wxQizhengWuXing非空

我·五行 key

self_wx_labelstring

我·五行展示

默认值: ""

graceQizhengWuXing非空

恩：生我者 key

grace_labelstring

恩·五行展示

默认值: ""

usefulQizhengWuXing非空

用：我生者 key

useful_labelstring

用·五行展示

默认值: ""

foeQizhengWuXing非空

仇：我克者 key

foe_labelstring

仇·五行展示

默认值: ""

hardshipQizhengWuXing非空

难：克我者 key

hardship_labelstring

难·五行展示

默认值: ""

示例数据

{
  "self_wx": "wood",
  "self_wx_label": "",
  "grace": "wood",
  "grace_label": "",
  "useful": "wood",
  "useful_label": "",
  "foe": "wood",
  "foe_label": "",
  "hardship": "wood",
  "hardship_label": ""
}

QizhengGraceVo

object

恩用仇难双行：度=命度主，宫=命宫宫主。非子平用神。

字段定义

degreeQizhengGraceRowVo非空

按命度主

palaceQizhengGraceRowVo非空

按命宫宫主

示例数据

{
  "degree": {
    "self_wx": "wood",
    "self_wx_label": "",
    "grace": "wood",
    "grace_label": "",
    "useful": "wood",
    "useful_label": "",
    "foe": "wood",
    "foe_label": "",
    "hardship": "wood",
    "hardship_label": ""
  },
  "palace": {
    "self_wx": "wood",
    "self_wx_label": "",
    "grace": "wood",
    "grace_label": "",
    "useful": "wood",
    "useful_label": "",
    "foe": "wood",
    "foe_label": "",
    "hardship": "wood",
    "hardship_label": ""
  }
}

QizhengHuaYaoGroupVo

object

化曜一列（按星耀网格的一列；竞品从右往左排）。

字段定义

primaryQizhengHuaYaoItemVo非空

天禄系主名，如天禄

ten_godQizhengHuaYaoItemVo | null

十神别名，如比肩；天贵列为空（正财挂天嗣列，对齐 Moira 十神模式）

tagsarray<QizhengHuaYaoItemVo>

附属星耀，自上而下；列归属由 Moira 看板表序固定，与落星无关

示例数据

{
  "primary": {
    "key": "string",
    "label": "",
    "natal_star": "sun",
    "natal_star_label": "",
    "flow_star": "sun",
    "flow_star_label": ""
  },
  "ten_god": {
    "key": "string",
    "label": "",
    "natal_star": "sun",
    "natal_star_label": "",
    "flow_star": "sun",
    "flow_star_label": ""
  },
  "tags": [
    {
      "key": "string",
      "natal_star": "sun"
    }
  ]
}

QizhengHuaYaoItemVo

object

化曜看板一项。

字段定义

keystring非空

stable key，如 tianLu / keMing

labelstring

展示名，如天禄、科名

默认值: ""

natal_starQizhengStarKey非空

本命落在十一曜 key

natal_star_labelstring

本命落星短名

默认值: ""

flow_starQizhengStarKey | null

流年落星 key；本命接口为空，chart 才填

flow_star_labelstring

流年落星短名

默认值: ""

示例数据

{
  "key": "string",
  "label": "",
  "natal_star": "sun",
  "natal_star_label": "",
  "flow_star": "sun",
  "flow_star_label": ""
}

QizhengJieQiVo

object

节气交节（本地时）。

字段定义

namestring非空

节气 stable key，如 bailu

name_labelstring

节气展示名，如白露

默认值: ""

atstring非空

交节本地时间 YYYY-MM-DD HH:MM:SS

示例数据

{
  "name": "示例名称",
  "name_label": "",
  "at": "string"
}

QizhengLimitYearVo

object

按虚岁一行：小限 / 飞限 / 童限。

字段定义

ageinteger非空

虚岁，出生年=1

yearinteger非空

公历年

gan_zhistring

该年干支展示

默认值: ""

xiao_xianQizhengEarthlyBranch非空

小限地支 key

xiao_xian_labelstring

小限地支展示

默认值: ""

fei_xianQizhengEarthlyBranch非空

飞限地支 key

fei_xian_labelstring

飞限地支展示

默认值: ""

tong_xianQizhengEarthlyBranch | null

童限地支 key

tong_xian_labelstring

童限地支展示

默认值: ""

示例数据

{
  "age": 1,
  "year": 0,
  "gan_zhi": "",
  "xiao_xian": "zi",
  "xiao_xian_label": "",
  "fei_xian": "zi",
  "fei_xian_label": "",
  "tong_xian": "zi",
  "tong_xian_label": ""
}

QizhengMingDegreeVo

object

命度 / 度主（盘心）。命宫地支见 palaces[0]，此处不重复。立命：时加太阳顺数至卯；宫内度同太阳，宿度对齐 Moira。

字段定义

palace_degreenumber非空

命度宫内度（与太阳宫内度相同）

xiuQizhengXiuKey非空

命度所在宿 key

xiu_labelstring

命度宿名

默认值: ""

xiu_degreenumber非空

命度宿内度

lordQizhengXiuLord非空

度主 key

lord_labelstring

度主展示名

默认值: ""

lord_type_labelstring

命度类型，如月度命

默认值: ""

示例数据

{
  "palace_degree": 0,
  "xiu": "jiao",
  "xiu_label": "",
  "xiu_degree": 0,
  "lord": "wood",
  "lord_label": "",
  "lord_type_label": ""
}

QizhengNatalVo

object

本命盘（不含行运）。

字段定义

genderstring非空

male / female；展示文案由前端映射

birth_dtstring非空

出生时间 YYYY-MM-DD HH:MM:SS

solar_dtstring非空

真太阳时 YYYY-MM-DD HH:MM:SS；未开则为 birth_dt

basicQizhengBasicVo非空

基础 tab：四柱/农历/节气/恩用/安身/童限时长

mingQizhengMingDegreeVo非空

命度（盘心）；命宫地支见 palaces[0]

starsarray<QizhengStarVo>非空

十一曜本命位置

palacesarray<QizhengPalaceVo>非空

十二宫，index 0–11

xiu_spansarray<QizhengXiuSpanVo>

二十八宿尺（随 xiu_ruler；默认今宿），供圆盘画宿圈

hua_yao_groupsarray<QizhengHuaYaoGroupVo>

aspectsarray<QizhengAspectVo>

本命合/冲/三合，供圆盘连线

patternsarray<QizhengPatternVo>

主流喜忌格（名称+吉凶）；前端按 type 分栏

dongwei_segmentsarray<QizhengDongweiSegmentVo>

洞微百六大限按宫段落（年龄/公历年），供圆盘最外圈；行限序

readingQizhengReadingVo | null

盘面解读 tab（总纲+要点；与基础/化曜/格局平级）；文案见 qizheng_reading.yaml

示例数据

{
  "gender": "string",
  "birth_dt": "string",
  "solar_dt": "string",
  "basic": {
    "pillars": {
      "year": {
        "stem": "string",
        "branch": "string",
        "stem_label": "",
        "branch_label": "",
        "gan_zhi": ""
      },
      "month": {
        "stem": "string",
        "branch": "string",
        "stem_label": "",
        "branch_label": "",
        "gan_zhi": ""
      },
      "day": {
        "stem": "string",
        "branch": "string",
        "stem_label": "",
        "branch_label": "",
        "gan_zhi": ""
      },
      "hour": {
        "stem": "string",
        "branch": "string",
        "stem_label": "",
        "branch_label": "",
        "gan_zhi": ""
      }
    },
    "lunar_date": "",
    "is_day": true,
    "day_night_label": "",
    "jie_qi": [
      {
        "name": "示例名称",
        "at": "string"
      }
    ],
    "grace": {
      "degree": {
        "self_wx": "wood",
        "self_wx_label": "",
        "grace": "wood",
        "grace_label": "",
        "useful": "wood",
        "useful_label": "",
        "foe": "wood",
        "foe_label": "",
        "hardship": "wood",
        "hardship_label": ""
      },
      "palace": {
        "self_wx": "wood",
        "self_wx_label": "",
        "grace": "wood",
        "grace_label": "",
        "useful": "wood",
        "useful_label": "",
        "foe": "wood",
        "foe_label": "",
        "hardship": "wood",
        "hardship_label": ""
      }
    },
    "shen": {
      "palace_degree": 0,
      "xiu": "jiao",
      "xiu_label": "",
      "xiu_degree": 0,
      "earthly_branch": "zi",
      "earthly_branch_label": ""
    },
    "tong_xian_span": {
      "years": 0,
      "months": 0,
      "days": 0,
      "exit_date": "2024-01-01",
      "label": ""
    }
  },
  "ming": {
    "palace_degree": 0,
    "xiu": "jiao",
    "xiu_label": "",
    "xiu_degree": 0,
    "lord": "wood",
    "lord_label": "",
    "lord_type_label": ""
  },
  "stars": [
    {
      "key": "sun",
      "longitude": 0,
      "speed": 0,
      "palace_degree": 0,
      "xiu_degree": {
        "xiu": "jiao",
        "degree": 0
      },
      "palace_index": 0
    }
  ],
  "palaces": [
    {
      "index": 0,
      "key": "ming",
      "earthly_branch": "zi"
    }
  ],
  "xiu_spans": [
    {
      "xiu": "jiao",
      "longitude_start": 0,
      "longitude_end": 0,
      "lord": "wood"
    }
  ],
  "hua_yao_groups": [
    {
      "primary": {
        "key": "string",
        "natal_star": "sun"
      }
    }
  ],
  "aspects": [
    {
      "from_star": "sun",
      "to_star": "sun",
      "type": "conjunct",
      "angle": 0,
      "orb": 0
    }
  ],
  "patterns": [
    {
      "key": "string",
      "type": "lucky"
    }
  ],
  "dongwei_segments": [
    {
      "sequence": 0,
      "palace_index": 0,
      "palace_key": "ming",
      "earthly_branch": "zi",
      "span_years": 0,
      "start_age": 0,
      "end_age": 0,
      "start_year": 0,
      "end_year": 0
    }
  ],
  "reading": {
    "summary": "",
    "highlights": [
      {
        "kind": "string",
        "key": "string"
      }
    ],
    "timing": {
      "title": "",
      "body": "",
      "items": [
        {
          "kind": "string",
          "key": "string"
        }
      ]
    },
    "relation": {
      "title": "",
      "body": "",
      "items": [
        {
          "kind": "string",
          "key": "string"
        }
      ]
    }
  }
}

QizhengPalaceVo

object

十二宫一格。

字段定义

indexinteger非空

偏移，0=命宫

keyQizhengPalaceKey非空

宫名 key

namestring

宫名展示，如财帛 / 財帛

默认值: ""

earthly_branchQizhengEarthlyBranch非空

宫支 key

earthly_branch_labelstring

宫支展示名

默认值: ""

spirit_starsarray<QizhengSpiritStar>

本命神煞 key（生月 + 生年干支）；展示名见 spirit_star_labels

spirit_star_labelsarray<string>

本命神煞展示名，与 spirit_stars 等长

flow_spirit_starsarray<QizhengSpiritStar>

外圈神煞 key：行运=流年干支神煞；比较盘=B 本命神煞（按 A 宫支落宫）；展示名见 flow_spirit_star_labels

flow_spirit_star_labelsarray<string>

流年神煞展示名，与 flow_spirit_stars 等长；本命接口为空

changshengQizhengChangSheng | null

长生十二神 key（年柱纳音，十二支顺行，每宫一颗）；展示名见 changsheng_label

changsheng_labelstring

长生十二神展示名

默认值: ""

示例数据

{
  "index": 0,
  "key": "ming",
  "name": "",
  "earthly_branch": "zi",
  "earthly_branch_label": "",
  "spirit_stars": [
    "tianDe"
  ],
  "spirit_star_labels": [
    "string"
  ],
  "flow_spirit_stars": [
    "tianDe"
  ],
  "flow_spirit_star_labels": [
    "string"
  ],
  "changsheng": "changSheng",
  "changsheng_label": ""
}

QizhengPatternVo

object

喜格 / 忌格。只含名称与吉凶；无断语/说明。

字段定义

keystring非空

格局 stable key，如 mercuryInDomicile

typeQizhengPatternType非空

lucky=喜格 / warning=忌格；栏名由前端展示

namestring

格局名，由 i18n 填充

默认值: ""

descriptionstring

l2qa2w

默认值: ""

示例数据

{
  "key": "string",
  "type": "lucky",
  "name": "",
  "description": ""
}

QizhengPillarVo

object

四柱之一柱。

字段定义

stemstring非空

天干 stable key

branchstring非空

地支 stable key

stem_labelstring

天干展示

默认值: ""

branch_labelstring

地支展示

默认值: ""

gan_zhistring

干支合写展示，如癸亥

默认值: ""

示例数据

{
  "stem": "string",
  "branch": "string",
  "stem_label": "",
  "branch_label": "",
  "gan_zhi": ""
}

QizhengPillarsVo

object

四柱（复用八字排盘口径，仅展示）。

字段定义

yearQizhengPillarVo非空

引用 QizhengPillarVo

monthQizhengPillarVo非空

引用 QizhengPillarVo

dayQizhengPillarVo非空

引用 QizhengPillarVo

hourQizhengPillarVo非空

引用 QizhengPillarVo

示例数据

{
  "year": {
    "stem": "string",
    "branch": "string",
    "stem_label": "",
    "branch_label": "",
    "gan_zhi": ""
  },
  "month": {
    "stem": "string",
    "branch": "string",
    "stem_label": "",
    "branch_label": "",
    "gan_zhi": ""
  },
  "day": {
    "stem": "string",
    "branch": "string",
    "stem_label": "",
    "branch_label": "",
    "gan_zhi": ""
  },
  "hour": {
    "stem": "string",
    "branch": "string",
    "stem_label": "",
    "branch_label": "",
    "gan_zhi": ""
  }
}

QizhengReadingItemVo

object

盘面解读一条要点（成段正文；空 body 表示语料未备、不展示）。

字段定义

kindstring非空

keystring非空

语料 stable key，如 moon / water / sunMercuryConjunct

tonestring

lucky|warning|neutral

默认值: "neutral"

titlestring

短标题；展示层填充

默认值: ""

bodystring

成段正文（约 120～280 字）；空则前端可隐藏本条

默认值: ""

refsobject

插值/跳转：star、palace、pattern_key、wx 等

示例数据

{
  "kind": "string",
  "key": "string",
  "tone": "neutral",
  "title": "",
  "body": "",
  "refs": {}
}

QizhengReadingRelationVo

object

比较盘 B in A 解读（仅 comparison；natal / chart 为空）。

字段定义

titlestring

小标题，如 B in A

默认值: ""

bodystring

成段总述；空则仍可只展示 items

默认值: ""

itemsarray<QizhengReadingItemVo>

交叉会合 / B 落关键宫等要点

示例数据

{
  "title": "",
  "body": "",
  "items": [
    {
      "kind": "string",
      "key": "string"
    }
  ]
}

QizhengReadingTimingVo

object

行运当前限解读（仅 chart；natal / comparison 为空）。

字段定义

titlestring

小标题，如当前运限

默认值: ""

bodystring

成段正文；空则不展示整块

默认值: ""

itemsarray<QizhengReadingItemVo>

大限/小限等分条（可选）

示例数据

{
  "title": "",
  "body": "",
  "items": [
    {
      "kind": "string",
      "key": "string"
    }
  ]
}

QizhengReadingVo

object

盘面解读 tab：与基础/化曜/格局平级。三模式共用；可变块按接口填充。

字段定义

summarystring

立命总纲（约 180～350 字，可含段落）；始终为本命 A

默认值: ""

highlightsarray<QizhengReadingItemVo>

本命要点卡（有 body 才纳入；条数有上限）；始终为 A

timingQizhengReadingTimingVo | null

当前运限专段；仅 /zhengyu/chart 有值

relationQizhengReadingRelationVo | null

B in A 专段；仅 /zhengyu/comparison 有值

示例数据

{
  "summary": "",
  "highlights": [
    {
      "kind": "string",
      "key": "string"
    }
  ],
  "timing": {
    "title": "",
    "body": "",
    "items": [
      {
        "kind": "string",
        "key": "string"
      }
    ]
  },
  "relation": {
    "title": "",
    "body": "",
    "items": [
      {
        "kind": "string",
        "key": "string"
      }
    ]
  }
}

QizhengShenDegreeVo

object

安身：太阴为身（宫度 + 宿度）。

字段定义

palace_degreenumber非空

身度宫内度（与月亮宫内度相同）

xiuQizhengXiuKey非空

身度所在宿 key

xiu_labelstring

身度宿名

默认值: ""

xiu_degreenumber非空

身度宿内度

earthly_branchQizhengEarthlyBranch非空

身宫地支 key

earthly_branch_labelstring

身宫地支展示

默认值: ""

示例数据

{
  "palace_degree": 0,
  "xiu": "jiao",
  "xiu_label": "",
  "xiu_degree": 0,
  "earthly_branch": "zi",
  "earthly_branch_label": ""
}

QizhengStarVo

object

十一曜一行。

字段定义

keyQizhengStarKey非空

星曜 key

labelstring

星曜短名，如日、罗 / 羅

默认值: ""

longitudenumber非空

回归黄经 0–360，春分=0

speednumber非空

黄经日速度（度/日）；逆行为负

palace_degreenumber非空

十二次宫内度 0–30；地支查 palaces[palace_index]

xiu_degreeQizhengXiuDegreeVo非空

宿度；宿名/度主查 xiu_spans

statusesarray<QizhengStarStatus>

迟留伏逆 key；主状态取列表首个

status_labelsarray<string>

状态展示名

dignitiesarray<QizhengDignity>

庙旺地力 key（殿垣庙旺乐喜怒，可多标）；未入表为空

dignity_labelstring

庙旺展示名（按序拼接，如垣乐）

默认值: ""

hua_yaoQizhengHuaYao | null

化曜主名 key（天禄系）；日为空

hua_yao_labelstring

化曜主名，如天刑

默认值: ""

ten_godQizhengTenGod | null

化曜十神别名 key；与 hua_yao 成对；日为空

ten_god_labelstring

十神一字，如煞；偏财=才、正财=财

默认值: ""

in_own_xiuboolean

得度：度主与本星同类

默认值: false

palace_indexinteger非空

所落十二宫偏移，0=命宫；宫名/宫支查 palaces[index]

示例数据

{
  "key": "sun",
  "label": "",
  "longitude": 0,
  "speed": 0,
  "palace_degree": 0,
  "xiu_degree": {
    "xiu": "jiao",
    "degree": 0
  },
  "statuses": [
    "retro"
  ],
  "status_labels": [
    "string"
  ],
  "dignities": [
    "dian"
  ],
  "dignity_label": "",
  "hua_yao": "tianLu",
  "hua_yao_label": "",
  "ten_god": "biJian",
  "ten_god_label": "",
  "in_own_xiu": false,
  "palace_index": 0
}

QizhengTongXianSpanVo

object

童限时长与出限日（基础 tab；与 limit_years[].tong_xian 宫位童限分列）。

字段定义

yearsinteger非空

整年

monthsinteger非空

整月

daysinteger非空

整日

exit_datestring非空

出限日 YYYY-MM-DD

labelstring

时长展示，如 12年11个月3天

默认值: ""

示例数据

{
  "years": 0,
  "months": 0,
  "days": 0,
  "exit_date": "2024-01-01",
  "label": ""
}

QizhengXiuDegreeVo

object

二十八宿宿度。宿名、度主查 xiu_spans 同 key。

字段定义

xiuQizhengXiuKey非空

二十八宿 key

degreenumber非空

宿内度（从该宿在尺上的起点起算，可跨宫累加）

示例数据

{
  "xiu": "jiao",
  "degree": 0
}

QizhengXiuSpanVo

object

量天尺一段，供圆盘画二十八宿圈。与 stars[].xiu_degree.xiu 同一把尺。

字段定义

xiuQizhengXiuKey非空

二十八宿 key

xiu_labelstring

宿名

默认值: ""

longitude_startnumber非空

黄经起点 0–360

longitude_endnumber非空

黄经终点；小于 start 表示跨 0°（如室）

lordQizhengXiuLord非空

度主 key：木金土日月火水

lord_labelstring

度主展示名

默认值: ""

示例数据

{
  "xiu": "jiao",
  "xiu_label": "",
  "longitude_start": 0,
  "longitude_end": 0,
  "lord": "wood",
  "lord_label": ""
}

ScopeInfoVo

object

单项运势信息

字段定义

labelstring非空

标签，如：爱情/事业/健康/财富

iconstring非空

图标URL

colorstring非空

颜色值

valnumber非空

运势分数，0-100

contentstring非空

运势内容

示例数据

{
  "label": "string",
  "icon": "string",
  "color": "string",
  "val": 0,
  "content": "string"
}

ScopeInterpretVo

object

运势解读

字段定义

chartTypestring非空

星盘类型

from_cnstring非空

主体对象中文名

to_cnstring非空

客体对象中文名（如：宫位名、星座名、其他行星名）

from_enstring非空

主体对象英文名（如：行星英文名）

to_enstring非空

客体对象英文名（如：行星英文名）

from_namestring非空

主体对象本地化名称，根据请求的 lang 参数支持不同语言

to_namestring非空

客体对象本地化名称，根据请求的 lang 参数支持不同语言

typestring非空

语料类型，值为：'PlanetToHouse', 'PlanetToSign', 'PlanetAspect0', 'PlanetAspect60', 'PlanetAspect90'等

in_outInOutType | null

入相/出相

occurred_at_tsinteger | null

星象发生的时间戳

start_daysinteger | null

星象开始天数

start_days_descstring | null

星象开始天数文字描述

remain_daysinteger | null

星象还剩多少天

remain_days_descstring | null

星象还剩多少天文字描述

total_span_daysinteger | null

事件总时长（天），约 start+remain

jx_typestring | null

星象吉凶，值为Ji/Xiong/Ping，分别代表吉/凶/平

tipstring | null

小贴士

titlestring非空

星象标题

contentstring非空

语料内容

impact_infoarray<ImpactInfo>

影响信息列表

示例数据

{
  "chartType": "string",
  "from_cn": "string",
  "to_cn": "string",
  "from_en": "string",
  "to_en": "string",
  "from_name": "示例名称",
  "to_name": "示例名称",
  "type": "string",
  "in_out": "In",
  "occurred_at_ts": 0,
  "start_days": 0,
  "start_days_desc": "string",
  "remain_days": 0,
  "remain_days_desc": "string",
  "total_span_days": 0,
  "jx_type": "string",
  "tip": "string",
  "title": "string",
  "content": "string",
  "impact_info": [
    {
      "key": "string",
      "cn_name": "示例名称",
      "trend": "up"
    }
  ]
}

ScopeRespVo

object

运势响应VO

字段定义

scope_infoarray<ScopeInfoVo>

各项运势信息

scope_totalScopeTotalVo | null

运势总分

commentCommentVo | null

运势建议（日运特有）

luck_infoarray<LuckInfoVo>

幸运信息列表

sign_infoSignScopeVo | null

星座信息

corpusarray<ScopeInterpretVo>

运势语料

示例数据

{
  "scope_info": [
    {
      "label": "string",
      "icon": "string",
      "color": "string",
      "val": 0,
      "content": "string"
    }
  ],
  "scope_total": {
    "label": "string",
    "val": 0,
    "start_date": "2024-01-01",
    "end_date": "2024-01-01",
    "tips": "string"
  },
  "comment": {
    "prefer": "",
    "avoid": "",
    "summary": ""
  },
  "luck_info": [
    {
      "label": "string",
      "val": "string",
      "icon": "string"
    }
  ],
  "sign_info": {
    "sign_name": "",
    "sign_icon": ""
  },
  "corpus": [
    {
      "chartType": "string",
      "from_cn": "string",
      "to_cn": "string",
      "from_en": "string",
      "to_en": "string",
      "from_name": "示例名称",
      "to_name": "示例名称",
      "type": "string",
      "title": "string",
      "content": "string"
    }
  ]
}

ScopeTotalVo

object

运势总分

字段定义

labelstring非空

标签，如：今日/本周/本月/本年

valnumber非空

运势分数，0-100

start_datestring | null

开始日期

end_datestring | null

结束日期

tipsstring | null

提示信息

示例数据

{
  "label": "string",
  "val": 0,
  "start_date": "2024-01-01",
  "end_date": "2024-01-01",
  "tips": "string"
}

SignCompatVo

object

星座配对信息视图对象

字段定义

from_sign_namestring | null

星座名称

from_img_urlstring | null

星座icon地址

to_sign_namestring | null

配对星座名称

to_img_urlstring | null

配对星座icon地址

scoreinteger非空

打分

commentstring非空

评语

male_descstring非空

星座(男)-配对星座(女)描述

female_descstring非空

星座(女)-配对星座(男)描述

示例数据

{
  "from_sign_name": "示例名称",
  "from_img_url": "https://api.apiworks.com",
  "to_sign_name": "示例名称",
  "to_img_url": "https://api.apiworks.com",
  "score": 0,
  "comment": "string",
  "male_desc": "string",
  "female_desc": "string"
}

SignExplainVo

object

行星星座解释信息

字段定义

labelstring非空

标签，格式：行星名星座名

plstring非空

行星中文名

signstring非空

星座中文名

tagstring非空

标签类型：Up/Down/空字符串

tag_imgstring非空

标签图片URL

summarystring非空

详细描述（JSON格式）

示例数据

{
  "label": "string",
  "pl": "string",
  "sign": "string",
  "tag": "string",
  "tag_img": "string",
  "summary": null
}

SignInfoVo

object

星座详细信息视图对象

字段定义

tagstring | null

信息所属类别，可能的值为：attr/base/desc

labelstring | null

标题

infostring | null

信息

示例数据

{
  "tag": "string",
  "label": "string",
  "info": "string"
}

SignScopeVo

object

星座信息

字段定义

sign_namestring

星座英文名

默认值: ""

sign_iconstring

星座图标URL

默认值: ""

示例数据

{
  "sign_name": "",
  "sign_icon": ""
}

ZiweiChartVo

object

星盘对象（包含运限数据）

字段定义

genderstring非空

性别（英文key，用于国际化）：'yang_male'（阳男）、'yang_female'（阳女）、'yin_male'（阴男）、'yin_female'（阴女）

birth_datestring非空

出生日期时间，格式：'YYYY-MM-DD HH:MM'

solar_datestring非空

出生真太阳时时间，格式：'YYYY-MM-DD HH:MM'

lunar_datestring非空

农历日期时间，格式：'年月日时'

lunar_ganzhistring非空

非节气四柱（农历四柱）

solar_term_ganzhistring非空

节气四柱（以24节气为基准的干支纪年日期）

zodiacstring非空

生肖

five_elements_classstring非空

五行局

natal_palace_idxinteger非空

命宫

body_palace_idxinteger非空

身宫

soul_lordstring非空

命主（星曜名称）

body_lordstring非空

身主（星曜名称）

birth_year_doujunstring非空

子年斗君（地支名称，如：申、丑等）

natalNatalHoroscope非空

本命运限数据

patternsarray<Pattern>

命盘格局列表

current_year_doujunstring非空

流年斗君（地支名称，如：申、丑等）

decadalHoroscope | null

大限运限数据

yearlyHoroscope | null

流年运限数据

monthlyHoroscope | null

流月运限数据

dailyHoroscope | null

流日运限数据

hourlyHoroscope | null

流时运限数据

示例数据

{
  "gender": "string",
  "birth_date": "2024-01-01",
  "solar_date": "2024-01-01",
  "lunar_date": "2024-01-01",
  "lunar_ganzhi": "string",
  "solar_term_ganzhi": "string",
  "zodiac": "string",
  "five_elements_class": "string",
  "natal_palace_idx": 0,
  "body_palace_idx": 0,
  "soul_lord": "string",
  "body_lord": "string",
  "birth_year_doujun": "string",
  "natal": {
    "mutagen_stars": {},
    "palaces": [
      {
        "index": 0,
        "name": "示例名称",
        "heavenly_stem": "string",
        "earthly_branch": "string",
        "life_12_star": "string"
      }
    ]
  },
  "patterns": [
    {
      "name": "示例名称",
      "description": "string",
      "type": "string"
    }
  ],
  "current_year_doujun": "string",
  "decadal": {
    "mutagen_stars": {},
    "palaces": [
      {
        "index": 0,
        "name": "示例名称"
      }
    ]
  },
  "yearly": {
    "mutagen_stars": {},
    "palaces": [
      {
        "index": 0,
        "name": "示例名称"
      }
    ]
  },
  "monthly": {
    "mutagen_stars": {},
    "palaces": [
      {
        "index": 0,
        "name": "示例名称"
      }
    ]
  },
  "daily": {
    "mutagen_stars": {},
    "palaces": [
      {
        "index": 0,
        "name": "示例名称"
      }
    ]
  },
  "hourly": {
    "mutagen_stars": {},
    "palaces": [
      {
        "index": 0,
        "name": "示例名称"
      }
    ]
  }
}

ZiweiDetailVo

object

包含星耀落宫解读的星盘对象

字段定义

genderstring非空

性别（英文key，用于国际化）：'yang_male'（阳男）、'yang_female'（阳女）、'yin_male'（阴男）、'yin_female'（阴女）

birth_datestring非空

出生日期时间，格式：'YYYY-MM-DD HH:MM'

solar_datestring非空

出生真太阳时时间，格式：'YYYY-MM-DD HH:MM'

lunar_datestring非空

农历日期时间，格式：'年月日时'

lunar_ganzhistring非空

非节气四柱（农历四柱）

solar_term_ganzhistring非空

节气四柱（以24节气为基准的干支纪年日期）

zodiacstring非空

生肖

five_elements_classstring非空

五行局

natal_palace_idxinteger非空

命宫

body_palace_idxinteger非空

身宫

soul_lordstring非空

命主（星曜名称）

body_lordstring非空

身主（星曜名称）

birth_year_doujunstring非空

子年斗君（地支名称，如：申、丑等）

natalNatalHoroscope非空

本命运限数据

patternsarray<Pattern>

命盘格局列表

current_year_doujunstring非空

流年斗君（地支名称，如：申、丑等）

decadalHoroscope | null

大限运限数据

yearlyHoroscope | null

流年运限数据

monthlyHoroscope | null

流月运限数据

dailyHoroscope | null

流日运限数据

hourlyHoroscope | null

流时运限数据

natal_star_interpsarray<StarInterpretation>

本命盘星耀落宫解读

decadal_star_interpsarray<StarInterpretation>

大限盘星耀落宫解读

yearly_star_interpsarray<StarInterpretation>

流年盘星耀落宫解读

monthly_star_interpsarray<StarInterpretation>

流月盘星耀落宫解读

daily_star_interpsarray<StarInterpretation>

流日盘星耀落宫解读

hourly_star_interpsarray<StarInterpretation>

流时盘星耀落宫解读

示例数据

{
  "gender": "string",
  "birth_date": "2024-01-01",
  "solar_date": "2024-01-01",
  "lunar_date": "2024-01-01",
  "lunar_ganzhi": "string",
  "solar_term_ganzhi": "string",
  "zodiac": "string",
  "five_elements_class": "string",
  "natal_palace_idx": 0,
  "body_palace_idx": 0,
  "soul_lord": "string",
  "body_lord": "string",
  "birth_year_doujun": "string",
  "natal": {
    "mutagen_stars": {},
    "palaces": [
      {
        "index": 0,
        "name": "示例名称",
        "heavenly_stem": "string",
        "earthly_branch": "string",
        "life_12_star": "string"
      }
    ]
  },
  "patterns": [
    {
      "name": "示例名称",
      "description": "string",
      "type": "string"
    }
  ],
  "current_year_doujun": "string",
  "decadal": {
    "mutagen_stars": {},
    "palaces": [
      {
        "index": 0,
        "name": "示例名称"
      }
    ]
  },
  "yearly": {
    "mutagen_stars": {},
    "palaces": [
      {
        "index": 0,
        "name": "示例名称"
      }
    ]
  },
  "monthly": {
    "mutagen_stars": {},
    "palaces": [
      {
        "index": 0,
        "name": "示例名称"
      }
    ]
  },
  "daily": {
    "mutagen_stars": {},
    "palaces": [
      {
        "index": 0,
        "name": "示例名称"
      }
    ]
  },
  "hourly": {
    "mutagen_stars": {},
    "palaces": [
      {
        "index": 0,
        "name": "示例名称"
      }
    ]
  },
  "natal_star_interps": [
    {
      "star_name": "示例名称",
      "palace_name": "示例名称",
      "interpretation": "string"
    }
  ],
  "decadal_star_interps": [
    {
      "star_name": "示例名称",
      "palace_name": "示例名称",
      "interpretation": "string"
    }
  ],
  "yearly_star_interps": [
    {
      "star_name": "示例名称",
      "palace_name": "示例名称",
      "interpretation": "string"
    }
  ],
  "monthly_star_interps": [
    {
      "star_name": "示例名称",
      "palace_name": "示例名称",
      "interpretation": "string"
    }
  ],
  "daily_star_interps": [
    {
      "star_name": "示例名称",
      "palace_name": "示例名称",
      "interpretation": "string"
    }
  ],
  "hourly_star_interps": [
    {
      "star_name": "示例名称",
      "palace_name": "示例名称",
      "interpretation": "string"
    }
  ]
}

ZiweiInfluenceVo

object

一方生年干对另一方本命盘的飞入影响

字段定义

year_stemstring非空

飞入方生年干 stable key

year_stem_labelstring

飞入方生年干展示文案

默认值: ""

mutagen_configstring

实际使用的四化配置 key，如 ji_1 / gui_1

默认值: ""

sihuaarray<ZiweiFlyInItem>

四化落入（禄权科忌顺序）

aux_starsarray<ZiweiAuxStarFlyIn>

禄存/擎羊/陀罗落入

sihua_linesarray<string>

四化展示行，如「化禄入福德宫」

aux_linestring

禄羊陀展示行

默认值: ""

示例数据

{
  "year_stem": "string",
  "year_stem_label": "",
  "mutagen_config": "",
  "sihua": [
    {
      "mutagen_type": "string",
      "star_name": "示例名称",
      "palace_name": "示例名称",
      "palace_index": 0
    }
  ],
  "aux_stars": [
    {
      "star_name": "示例名称",
      "palace_name": "示例名称",
      "palace_index": 0
    }
  ],
  "sihua_lines": [
    "string"
  ],
  "aux_line": ""
}

ZiweiMatchVo

object

紫微合盘（生年干互飞）

字段定义

self_natalZiweiNatalVo非空

本人本命盘

other_natalZiweiNatalVo非空

对方本命盘

influence_on_selfZiweiInfluenceVo非空

对方对自己的影响（对方年干飞入本人盘）

influence_on_otherZiweiInfluenceVo非空

自己对对方的影响（本人年干飞入对方盘）

示例数据

{
  "self_natal": {
    "gender": "string",
    "birth_date": "2024-01-01",
    "solar_date": "2024-01-01",
    "lunar_date": "2024-01-01",
    "lunar_ganzhi": "string",
    "solar_term_ganzhi": "string",
    "zodiac": "string",
    "five_elements_class": "string",
    "natal_palace_idx": 0,
    "body_palace_idx": 0,
    "soul_lord": "string",
    "body_lord": "string",
    "birth_year_doujun": "string",
    "natal": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称",
          "heavenly_stem": "string",
          "earthly_branch": "string",
          "life_12_star": "string"
        }
      ]
    },
    "patterns": [
      {
        "name": "示例名称",
        "description": "string",
        "type": "string"
      }
    ]
  },
  "other_natal": {
    "gender": "string",
    "birth_date": "2024-01-01",
    "solar_date": "2024-01-01",
    "lunar_date": "2024-01-01",
    "lunar_ganzhi": "string",
    "solar_term_ganzhi": "string",
    "zodiac": "string",
    "five_elements_class": "string",
    "natal_palace_idx": 0,
    "body_palace_idx": 0,
    "soul_lord": "string",
    "body_lord": "string",
    "birth_year_doujun": "string",
    "natal": {
      "mutagen_stars": {},
      "palaces": [
        {
          "index": 0,
          "name": "示例名称",
          "heavenly_stem": "string",
          "earthly_branch": "string",
          "life_12_star": "string"
        }
      ]
    },
    "patterns": [
      {
        "name": "示例名称",
        "description": "string",
        "type": "string"
      }
    ]
  },
  "influence_on_self": {
    "year_stem": "string",
    "year_stem_label": "",
    "mutagen_config": "",
    "sihua": [
      {
        "mutagen_type": "string",
        "star_name": "示例名称",
        "palace_name": "示例名称",
        "palace_index": 0
      }
    ],
    "aux_stars": [
      {
        "star_name": "示例名称",
        "palace_name": "示例名称",
        "palace_index": 0
      }
    ],
    "sihua_lines": [
      "string"
    ],
    "aux_line": ""
  },
  "influence_on_other": {
    "year_stem": "string",
    "year_stem_label": "",
    "mutagen_config": "",
    "sihua": [
      {
        "mutagen_type": "string",
        "star_name": "示例名称",
        "palace_name": "示例名称",
        "palace_index": 0
      }
    ],
    "aux_stars": [
      {
        "star_name": "示例名称",
        "palace_name": "示例名称",
        "palace_index": 0
      }
    ],
    "sihua_lines": [
      "string"
    ],
    "aux_line": ""
  }
}

ZiweiNatalVo

object

本命盘对象（不包含运限数据）

字段定义

genderstring非空

性别（英文key，用于国际化）：'yang_male'（阳男）、'yang_female'（阳女）、'yin_male'（阴男）、'yin_female'（阴女）

birth_datestring非空

出生日期时间，格式：'YYYY-MM-DD HH:MM'

solar_datestring非空

出生真太阳时时间，格式：'YYYY-MM-DD HH:MM'

lunar_datestring非空

农历日期时间，格式：'年月日时'

lunar_ganzhistring非空

非节气四柱（农历四柱）

solar_term_ganzhistring非空

节气四柱（以24节气为基准的干支纪年日期）

zodiacstring非空

生肖

five_elements_classstring非空

五行局

natal_palace_idxinteger非空

命宫

body_palace_idxinteger非空

身宫

soul_lordstring非空

命主（星曜名称）

body_lordstring非空

身主（星曜名称）

birth_year_doujunstring非空

子年斗君（地支名称，如：申、丑等）

natalNatalHoroscope非空

本命运限数据

patternsarray<Pattern>

命盘格局列表

示例数据

{
  "gender": "string",
  "birth_date": "2024-01-01",
  "solar_date": "2024-01-01",
  "lunar_date": "2024-01-01",
  "lunar_ganzhi": "string",
  "solar_term_ganzhi": "string",
  "zodiac": "string",
  "five_elements_class": "string",
  "natal_palace_idx": 0,
  "body_palace_idx": 0,
  "soul_lord": "string",
  "body_lord": "string",
  "birth_year_doujun": "string",
  "natal": {
    "mutagen_stars": {},
    "palaces": [
      {
        "index": 0,
        "name": "示例名称",
        "heavenly_stem": "string",
        "earthly_branch": "string",
        "life_12_star": "string"
      }
    ]
  },
  "patterns": [
    {
      "name": "示例名称",
      "description": "string",
      "type": "string"
    }
  ]
}

SignVo

object

星座信息视图对象

字段定义

sign_idinteger非空

星座ID

sign_enstring非空

星座英文名

sign_cnstring非空

星座中文名

sign_namestring非空

星座本地化名称，根据请求的lang参数支持不同语言

sign_fontstring非空

星座字体

sign_attributearray<string>非空

星座属性

sign_guardianarray<SignGuardian>非空

守护星列表

planet_arrayarray<SignPlanet>非空

星座内行星列表

示例数据

{
  "sign_id": 0,
  "sign_en": "string",
  "sign_cn": "string",
  "sign_name": "示例名称",
  "sign_font": "string",
  "sign_attribute": [
    "string"
  ],
  "sign_guardian": [
    {
      "planet_code": "string",
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "planet_font": "string"
    }
  ],
  "planet_array": [
    {
      "planet_code": "string",
      "planet_en": "string",
      "planet_cn": "string",
      "planet_name": "示例名称",
      "longitude": 0,
      "house_id": 0,
      "speed": 0,
      "planet_font": "string",
      "deg": 0,
      "min": 0,
      "sec": 0
    }
  ]
}

SignVo

object

星座相关信息

字段定义

idinteger非空

星座ID

namestring非空

星座名称

en_namestring非空

星座英文名称

attrstring | null

四象属性

img_urlstring | null

icon地址

rec_img_urlstring | null

方形icon地址

circle_img_urlstring | null

圆形icon地址

datestring | null

日期范围

detailsarray<SignInfoVo> | null

详细信息

示例数据

{
  "id": 0,
  "name": "示例名称",
  "en_name": "示例名称",
  "attr": "string",
  "img_url": "https://api.apiworks.com",
  "rec_img_url": "https://api.apiworks.com",
  "circle_img_url": "https://api.apiworks.com",
  "date": "2024-01-01",
  "details": [
    {}
  ]
}

其他数据模型

业务数据模型的结构定义。

AttributePlanet

object

属性行星信息

字段定义

planet_enstring非空

行星英文名

planet_cnstring非空

行星中文名

planet_namestring非空

行星本地化名称，根据请求的lang参数支持不同语言

planet_codestring非空

行星代码

longitudenumber非空

行星黄道经度

house_idinteger非空

行星所在宫位ID

speednumber非空

行星速度

planet_fontstring非空

行星字体

deginteger非空

度

mininteger非空

分

secinteger非空

秒

sign_idinteger非空

星座ID

sign_enstring非空

星座英文名

sign_cnstring非空

星座中文名

sign_namestring非空

星座本地化名称，根据请求的lang参数支持不同语言

sign_fontstring非空

星座字体

示例数据

{
  "planet_en": "string",
  "planet_cn": "string",
  "planet_name": "示例名称",
  "planet_code": "string",
  "longitude": 0,
  "house_id": 0,
  "speed": 0,
  "planet_font": "string",
  "deg": 0,
  "min": 0,
  "sec": 0,
  "sign_id": 0,
  "sign_en": "string",
  "sign_cn": "string",
  "sign_name": "示例名称",
  "sign_font": "string"
}

AyType

string

黄道类型（Tropical: 回归黄道；Sidereal: 恒星黄道）

枚举值

TropicalSidereal

示例数据

"Tropical"

BaziFlowVO

object

八字流盘响应VO

字段定义

target_dtstring非空

目标日期时间，格式：'YYYY-MM-DD HH:MM'

pillarsarray<PillarInfo>非空

八字四柱信息

flow_start_dtstring非空

大运开始时间，格式：'YYYY-MM-DD HH:MM'

flow_decadalarray<FlowInfo>非空

大运信息

flow_yeararray<FlowInfo>非空

流年信息

flow_montharray<FlowInfo>非空

流月信息

flow_dayarray<FlowInfo>非空

流日信息

flow_hourarray<FlowInfo>非空

流时信息

tg_chong_kearray<string>非空

天干冲克信息

dz_chong_kearray<string>非空

地支冲克信息

flow_tg_chong_kearray<string>非空

流盘天干冲克信息

flow_dz_chong_kearray<string>非空

流盘地支冲克信息

示例数据

{
  "target_dt": "string",
  "pillars": [
    {
      "type": "natal_year",
      "tg": "string",
      "dz": "string",
      "gan_shen": "string",
      "gan_shen_short": "string",
      "zhi_shen": [
        "string"
      ],
      "zhi_shen_short": [
        "string"
      ],
      "cang_gan_wx": [
        "string"
      ],
      "cang_gan_zs": [
        "string"
      ],
      "na_yin": "string",
      "kong_wang": "string",
      "di_shi": "string",
      "zi_zuo": "string",
      "shen_sha": [
        "string"
      ]
    }
  ],
  "flow_start_dt": "string",
  "flow_decadal": [
    {
      "type": "natal_year",
      "key": "string",
      "tg": "string",
      "tg_shen_sha": "string",
      "dz": "string",
      "dz_shen_sha": "string",
      "is_current": true
    }
  ],
  "flow_year": [
    {
      "type": "natal_year",
      "key": "string",
      "tg": "string",
      "tg_shen_sha": "string",
      "dz": "string",
      "dz_shen_sha": "string",
      "is_current": true
    }
  ],
  "flow_month": [
    {
      "type": "natal_year",
      "key": "string",
      "tg": "string",
      "tg_shen_sha": "string",
      "dz": "string",
      "dz_shen_sha": "string",
      "is_current": true
    }
  ],
  "flow_day": [
    {
      "type": "natal_year",
      "key": "string",
      "tg": "string",
      "tg_shen_sha": "string",
      "dz": "string",
      "dz_shen_sha": "string",
      "is_current": true
    }
  ],
  "flow_hour": [
    {
      "type": "natal_year",
      "key": "string",
      "tg": "string",
      "tg_shen_sha": "string",
      "dz": "string",
      "dz_shen_sha": "string",
      "is_current": true
    }
  ],
  "tg_chong_ke": [
    "string"
  ],
  "dz_chong_ke": [
    "string"
  ],
  "flow_tg_chong_ke": [
    "string"
  ],
  "flow_dz_chong_ke": [
    "string"
  ]
}

BaziFullVO

object

八字综合响应VO（命盘 + 流盘 + 总结）

字段定义

natalBaziNatalVO非空

八字命盘

flowBaziFlowVO非空

八字流盘

summaryBaziSummaryVO非空

八字总结

示例数据

{
  "natal": {
    "birth_dt": "string",
    "birth_solar_dt": "string",
    "birth_lunar": "string",
    "birth_solar_term": "string",
    "tg_chong_ke": [
      "string"
    ],
    "dz_chong_ke": [
      "string"
    ],
    "pillars": [
      {
        "type": "natal_year",
        "tg": "string",
        "dz": "string",
        "gan_shen": "string",
        "gan_shen_short": "string",
        "zhi_shen": [
          "string"
        ],
        "zhi_shen_short": [
          "string"
        ],
        "cang_gan_wx": [
          "string"
        ],
        "cang_gan_zs": [
          "string"
        ],
        "na_yin": "string",
        "kong_wang": "string",
        "di_shi": "string",
        "zi_zuo": "string",
        "shen_sha": [
          "string"
        ]
      }
    ],
    "flow_start_dt": "string",
    "flow_decadal": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "wang_xiang": [
      "string"
    ],
    "misc": {
      "tai_yuan": "string",
      "tai_yuan_na_yin": "string",
      "tai_xi": "string",
      "tai_xi_na_yin": "string",
      "ming_gong": "string",
      "ming_gong_na_yin": "string",
      "shen_gong": "string",
      "shen_gong_na_yin": "string",
      "ming_gua": "string",
      "siling_fenye": "string"
    }
  },
  "flow": {
    "target_dt": "string",
    "pillars": [
      {
        "type": "natal_year",
        "tg": "string",
        "dz": "string",
        "gan_shen": "string",
        "gan_shen_short": "string",
        "zhi_shen": [
          "string"
        ],
        "zhi_shen_short": [
          "string"
        ],
        "cang_gan_wx": [
          "string"
        ],
        "cang_gan_zs": [
          "string"
        ],
        "na_yin": "string",
        "kong_wang": "string",
        "di_shi": "string",
        "zi_zuo": "string",
        "shen_sha": [
          "string"
        ]
      }
    ],
    "flow_start_dt": "string",
    "flow_decadal": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "flow_year": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "flow_month": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "flow_day": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "flow_hour": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "tg_chong_ke": [
      "string"
    ],
    "dz_chong_ke": [
      "string"
    ],
    "flow_tg_chong_ke": [
      "string"
    ],
    "flow_dz_chong_ke": [
      "string"
    ]
  },
  "summary": {
    "general_desc": "string",
    "wx_info": [
      {
        "wx": "string",
        "is_day_master": true,
        "ratio": 0,
        "shi_shen": [
          "string"
        ]
      }
    ],
    "yin_yang": "string",
    "yin_yang_desc": "string",
    "qiang_ruo": "string",
    "qiang_ruo_desc": "string",
    "ge_ju": "string",
    "ge_ju_desc": "string",
    "xi_yong_shen": [
      "string"
    ],
    "ji_yong_shen": [
      "string"
    ],
    "lucky_info": {},
    "qi_he_partner": "string",
    "qi_he_partner_desc": "string"
  }
}

BaziMatchVO

object

八字合盘响应VO

字段定义

your_natalBaziNatalVO非空

你的八字命盘信息

other_natalBaziNatalVO非空

对方的八字命盘信息

interpretationstring非空

合盘解读信息

示例数据

{
  "your_natal": {
    "birth_dt": "string",
    "birth_solar_dt": "string",
    "birth_lunar": "string",
    "birth_solar_term": "string",
    "tg_chong_ke": [
      "string"
    ],
    "dz_chong_ke": [
      "string"
    ],
    "pillars": [
      {
        "type": "natal_year",
        "tg": "string",
        "dz": "string",
        "gan_shen": "string",
        "gan_shen_short": "string",
        "zhi_shen": [
          "string"
        ],
        "zhi_shen_short": [
          "string"
        ],
        "cang_gan_wx": [
          "string"
        ],
        "cang_gan_zs": [
          "string"
        ],
        "na_yin": "string",
        "kong_wang": "string",
        "di_shi": "string",
        "zi_zuo": "string",
        "shen_sha": [
          "string"
        ]
      }
    ],
    "flow_start_dt": "string",
    "flow_decadal": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "wang_xiang": [
      "string"
    ],
    "misc": {
      "tai_yuan": "string",
      "tai_yuan_na_yin": "string",
      "tai_xi": "string",
      "tai_xi_na_yin": "string",
      "ming_gong": "string",
      "ming_gong_na_yin": "string",
      "shen_gong": "string",
      "shen_gong_na_yin": "string",
      "ming_gua": "string",
      "siling_fenye": "string"
    }
  },
  "other_natal": {
    "birth_dt": "string",
    "birth_solar_dt": "string",
    "birth_lunar": "string",
    "birth_solar_term": "string",
    "tg_chong_ke": [
      "string"
    ],
    "dz_chong_ke": [
      "string"
    ],
    "pillars": [
      {
        "type": "natal_year",
        "tg": "string",
        "dz": "string",
        "gan_shen": "string",
        "gan_shen_short": "string",
        "zhi_shen": [
          "string"
        ],
        "zhi_shen_short": [
          "string"
        ],
        "cang_gan_wx": [
          "string"
        ],
        "cang_gan_zs": [
          "string"
        ],
        "na_yin": "string",
        "kong_wang": "string",
        "di_shi": "string",
        "zi_zuo": "string",
        "shen_sha": [
          "string"
        ]
      }
    ],
    "flow_start_dt": "string",
    "flow_decadal": [
      {
        "type": "natal_year",
        "key": "string",
        "tg": "string",
        "tg_shen_sha": "string",
        "dz": "string",
        "dz_shen_sha": "string",
        "is_current": true
      }
    ],
    "wang_xiang": [
      "string"
    ],
    "misc": {
      "tai_yuan": "string",
      "tai_yuan_na_yin": "string",
      "tai_xi": "string",
      "tai_xi_na_yin": "string",
      "ming_gong": "string",
      "ming_gong_na_yin": "string",
      "shen_gong": "string",
      "shen_gong_na_yin": "string",
      "ming_gua": "string",
      "siling_fenye": "string"
    }
  },
  "interpretation": "string"
}

BaziNatalMiscVO

object

八字命盘附属信息（胎元胎息干支与纳音、八字命身宫干支及纳音、八宅命卦、司令分野）

字段定义

tai_yuanstring非空

胎元干支（月干顺推一位、月支顺推三位），如戊子

tai_yuan_na_yinstring非空

胎元纳音名称，如壁上土

tai_xistring非空

胎息干支（日干取天干五合、日支取地支六合），如癸未

tai_xi_na_yinstring非空

胎息纳音名称，如泉中水

ming_gongstring非空

命宫干支，如己巳

ming_gong_na_yinstring非空

命宫六十甲子纳音

shen_gongstring非空

身宫干支，如丁丑

shen_gong_na_yinstring非空

身宫六十甲子纳音

ming_guastring非空

八宅三元命卦

siling_fenyestring非空

人元司令分野，如戊土用事/丙火用事/甲木用事

示例数据

{
  "tai_yuan": "string",
  "tai_yuan_na_yin": "string",
  "tai_xi": "string",
  "tai_xi_na_yin": "string",
  "ming_gong": "string",
  "ming_gong_na_yin": "string",
  "shen_gong": "string",
  "shen_gong_na_yin": "string",
  "ming_gua": "string",
  "siling_fenye": "string"
}

BaziNatalVO

object

八字命盘响应VO

字段定义

birth_dtstring非空

出生时间，格式：'YYYY-MM-DD HH:MM:SS'

birth_solar_dtstring非空

出生真太阳时时间，格式：'YYYY-MM-DD HH:MM'

birth_lunarstring非空

农历出生日期时间，格式：'干支年月日时辰'

birth_solar_termstring非空

出生节气

tg_chong_kearray<string>非空

天干冲克信息

dz_chong_kearray<string>非空

地支冲克信息

pillarsarray<PillarInfo>非空

四柱信息

flow_start_dtstring非空

大运开始时间，格式：'YYYY-MM-DD HH:MM'

flow_decadalarray<FlowInfo>非空

大运信息

wang_xiangarray<string>非空

旺相囚死信息

miscBaziNatalMiscVO非空

附属信息（胎元胎息、命宫身宫、八宅命卦、司令分野等）

示例数据

{
  "birth_dt": "string",
  "birth_solar_dt": "string",
  "birth_lunar": "string",
  "birth_solar_term": "string",
  "tg_chong_ke": [
    "string"
  ],
  "dz_chong_ke": [
    "string"
  ],
  "pillars": [
    {
      "type": "natal_year",
      "tg": "string",
      "dz": "string",
      "gan_shen": "string",
      "gan_shen_short": "string",
      "zhi_shen": [
        "string"
      ],
      "zhi_shen_short": [
        "string"
      ],
      "cang_gan_wx": [
        "string"
      ],
      "cang_gan_zs": [
        "string"
      ],
      "na_yin": "string",
      "kong_wang": "string",
      "di_shi": "string",
      "zi_zuo": "string",
      "shen_sha": [
        "string"
      ]
    }
  ],
  "flow_start_dt": "string",
  "flow_decadal": [
    {
      "type": "natal_year",
      "key": "string",
      "tg": "string",
      "tg_shen_sha": "string",
      "dz": "string",
      "dz_shen_sha": "string",
      "is_current": true
    }
  ],
  "wang_xiang": [
    "string"
  ],
  "misc": {
    "tai_yuan": "string",
    "tai_yuan_na_yin": "string",
    "tai_xi": "string",
    "tai_xi_na_yin": "string",
    "ming_gong": "string",
    "ming_gong_na_yin": "string",
    "shen_gong": "string",
    "shen_gong_na_yin": "string",
    "ming_gua": "string",
    "siling_fenye": "string"
  }
}

BaziPillarType

string

八字四柱类型

枚举值

natal_yearnatal_monthnatal_daynatal_hourdecadalannualmonthlydailyhourly

示例数据

"natal_year"

BaziSummaryVO

object

八字总结响应VO

字段定义

general_descstring非空

总体描述

wx_infoarray<WxInfo>非空

五行信息

yin_yangstring非空

阴阳属性

yin_yang_descstring非空

阴阳属性描述

qiang_ruostring非空

强弱属性

qiang_ruo_descstring非空

强弱属性描述

ge_justring非空

格局

ge_ju_descstring非空

格局描述

xi_yong_shenarray<string>非空

喜用五行，如 ['火', '土']

ji_yong_shenarray<string>非空

忌用五行，如 ['金']

lucky_infoobject非空

幸运数字，幸运方位，幸运颜色等等

qi_he_partnerstring非空

契合伴侣信息

qi_he_partner_descstring非空

契合伴侣描述

示例数据

{
  "general_desc": "string",
  "wx_info": [
    {
      "wx": "string",
      "is_day_master": true,
      "ratio": 0,
      "shi_shen": [
        "string"
      ]
    }
  ],
  "yin_yang": "string",
  "yin_yang_desc": "string",
  "qiang_ruo": "string",
  "qiang_ruo_desc": "string",
  "ge_ju": "string",
  "ge_ju_desc": "string",
  "xi_yong_shen": [
    "string"
  ],
  "ji_yong_shen": [
    "string"
  ],
  "lucky_info": {},
  "qi_he_partner": "string",
  "qi_he_partner_desc": "string"
}

BirthInfo

object

出生信息

字段定义

birth_dtstring非空

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber | null

经度，可选

latitudenumber | null

纬度，可选

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

user_idstring | null

用户标识,用于在星宿关系中识别具体用户，服务端会原样返回

默认值: ""

示例数据

{
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 0,
  "latitude": 0,
  "dst_auto": true,
  "user_id": ""
}

ChartFormatType

string

星盘格式类型（Classical: 古典盘；Modern: 现代盘）

枚举值

ClassicalModern

示例数据

"Classical"

FlowInfo

object

八字流盘信息

字段定义

typeBaziPillarType非空

四柱类型

keystring非空

流盘关键字

sub_keystring | null

流盘子关键字

tgstring非空

天干

tg_shen_shastring非空

天干神煞

dzstring非空

地支

dz_shen_shastring非空

地支神煞

is_currentboolean非空

是否为当前时段

示例数据

{
  "type": "natal_year",
  "key": "string",
  "sub_key": "string",
  "tg": "string",
  "tg_shen_sha": "string",
  "dz": "string",
  "dz_shen_sha": "string",
  "is_current": true
}

GenderType

string

性别类型（紫微斗数）（male: 男；female: 女）

枚举值

malefemale

示例数据

"male"

HTTPValidationError

object

字段定义

detailarray<ValidationError>

示例数据

{
  "detail": [
    {
      "loc": [
        null
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Horoscope

object

运限对象

字段定义

mutagen_starsobject

四化星名称与星曜名称的映射，key 为星曜名称，value 为四化星名称

palacesarray<HoroscopePalace>非空

运限宫位对象列表

示例数据

{
  "mutagen_stars": {},
  "palaces": [
    {
      "index": 0,
      "name": "示例名称"
    }
  ]
}

HoroscopePalace

object

运限宫位对象

字段定义

indexinteger非空

对应本命盘的索引（0-11）

namestring非空

宫位名称

spirit_starsarray<string>

神煞星曜数组

默认值: []

dynamic_starsarray<string>

动态星曜数组

默认值: []

示例数据

{
  "index": 0,
  "name": "示例名称",
  "spirit_stars": [],
  "dynamic_stars": []
}

HouseSystemType

string

宫位系统类型（P: Placidus；K: Koch；C: Campanus；R: Regiomontanus；U: Krusinski；E: Equal；V: Vehlow；W: Whole Signs；D: Equal/MC；N: Equal/Zodiac；O: Porphyry；B: Alcabitius；X: Meridian；F: Carter；M: Morinus；T: Polich/Page；H: Horizon；G: Gauquelin）

枚举值

PKCRUEVWDNOBXFMTHG

示例数据

"P"

ImpactInfo

object

当前星象对各运势维度（key）的倾向：仅上升/下降两态，对齐测测类上/下箭头（无中性条目）。

字段定义

keystring非空

关联层面，比如'love','study','friends'等

cn_namestring非空

关联层面中文名

trendstring非空

该维度影响走向：up 上升/加强，down 下降/减弱（前端可映射为上/下箭头或 true/false）

示例数据

{
  "key": "string",
  "cn_name": "示例名称",
  "trend": "up"
}

InOutType

string

入相位/出相位（In: 入相位；Out: 出相位）

枚举值

InOut

示例数据

"In"

LeapBoundaryType

string

闰月分界类型（mid_month: 月中分隔；current_month: 隶属本月；next_month: 隶属下月）

枚举值

mid_monthcurrent_monthnext_month

示例数据

"mid_month"

LiurenChuan

object

六壬三传之一。

字段定义

namestring非空

初传 / 中传 / 末传

gan_zhistring非空

传支干支

shenstring非空

天将名

示例数据

{
  "name": "示例名称",
  "gan_zhi": "string",
  "shen": "string"
}

LiurenDiFen

string

金口诀地分（十二地支）（zi: 子；chou: 丑；yin: 寅；mao: 卯；chen: 辰；si: 巳；wu: 午；wei: 未；shen: 申；you: 酉；xu: 戌；hai: 亥）

枚举值

zichouyinmaochensiwuweishenyouxuhai

示例数据

"zi"

LiurenGuiRenMethod

string

贵人起法（tian: 天贵；di: 地贵）

枚举值

tiandi

示例数据

"tian"

LiurenKe

object

六壬四课之一。

字段定义

namestring非空

第一课、第二课…

tianstring非空

上神

distring非空

下神

示例数据

{
  "name": "示例名称",
  "tian": "string",
  "di": "string"
}

LiurenPanType

string

六壬排盘流派 / 术式类型（daliuren: 大六壬；jinkoujue: 金口诀）

枚举值

daliurenjinkoujue

示例数据

"daliuren"

MainPlanet

object

宫主星信息

字段定义

planet_codestring非空

行星代码

planet_enstring非空

行星英文名

planet_cnstring非空

行星中文名

planet_namestring非空

行星本地化名称，根据请求的lang参数支持不同语言

planet_fontstring非空

行星字体

示例数据

{
  "planet_code": "string",
  "planet_en": "string",
  "planet_cn": "string",
  "planet_name": "示例名称",
  "planet_font": "string"
}

MingShenGongMonthRule

string

八字命身宫「月令」地支的起算规则（用于 26-(月+时) / (月+时) 中的月支）。

枚举值

solar_termzhongqi

示例数据

"solar_term"

MutagenType

string

四化配置类型（按天干分类）

枚举值

jia_1jia_2yi_1bing_1ding_1wu_1wu_2ji_1geng_1geng_2xin_1xin_2ren_1ren_2gui_1gui_2

示例数据

"jia_1"

NaksInfo

object

星宿信息

字段定义

idxinteger非空

星宿ID

namestring非空

星宿名称

user_idstring | null

用户标识，服务端原样返回

tipstring

星宿短标签

默认值: ""

briefstring

星宿一句话简介

默认值: ""

示例数据

{
  "idx": 0,
  "name": "示例名称",
  "user_id": "12345",
  "tip": "",
  "brief": ""
}

NaksRelation

object

星宿关系

字段定义

other_naksNaksInfo非空

对方星宿信息

relation_typeNaksRelationType非空

关系类型

is_reverseboolean非空

是否为反向关系

commentsNaksRelationComments | null

关系语料

示例数据

{
  "other_naks": {
    "idx": 0,
    "name": "示例名称",
    "user_id": "12345",
    "tip": "",
    "brief": ""
  },
  "relation_type": "AN_HUAI",
  "is_reverse": true,
  "comments": {
    "description": "string",
    "comments": []
  }
}

NaksRelationComments

object

星宿关系语料

字段定义

descriptionstring非空

asmns9

commentsarray<Section>

附加描述信息

默认值: []

示例数据

{
  "description": "string",
  "comments": []
}

NaksRelationType

string

星宿关系类型枚举（AN_HUAI: 安坏；RONG_QIN: 荣亲；YE_TAI: 业胎；YOU_SHUAI: 友衰；MING_ZHI_XING: 命之星；WEI_CHENG: 危成）

枚举值

AN_HUAIRONG_QINYE_TAIYOU_SHUAIMING_ZHI_XINGWEI_CHENG

示例数据

"AN_HUAI"

NatalHoroscope

object

本命运限对象

字段定义

mutagen_starsobject

四化星名称与星曜名称的映射，key 为星曜名称，value 为四化星名称

palacesarray<NatalPalace>非空

本命宫位对象列表

示例数据

{
  "mutagen_stars": {},
  "palaces": [
    {
      "index": 0,
      "name": "示例名称",
      "heavenly_stem": "string",
      "earthly_branch": "string",
      "life_12_star": "string"
    }
  ]
}

NatalPalace

object

本命宫位对象（包含所有本命星曜）

字段定义

indexinteger非空

宫位索引（0-11，从寅宫开始）

namestring非空

宫位名称

heavenly_stemstring非空

宫位天干

earthly_branchstring非空

宫位地支

major_starsarray<StarWithMutagen>

主星列表

minor_starsarray<StarWithMutagen>

辅星列表

adj_starsarray<Star>

杂曜列表

life_12_starstring非空

长生十二神（每个宫位一个）

spirit_starsarray<string>

神煞星曜数组

默认值: []

range_startinteger | null

大限起始年龄

range_endinteger | null

大限截止年龄

in_rangeboolean

是否在大限范围内

默认值: false

decadalarray<integer>

大限关联的流年

默认值: []

mutagen_infosarray<PalaceMutagenItem>

该宫对应的四化信息

默认值: []

示例数据

{
  "index": 0,
  "name": "示例名称",
  "heavenly_stem": "string",
  "earthly_branch": "string",
  "major_stars": [
    {
      "name": "示例名称",
      "type": "string"
    }
  ],
  "minor_stars": [
    {
      "name": "示例名称",
      "type": "string"
    }
  ],
  "adj_stars": [
    {
      "name": "示例名称",
      "type": "string"
    }
  ],
  "life_12_star": "string",
  "spirit_stars": [],
  "range_start": 0,
  "range_end": 0,
  "in_range": false,
  "decadal": [],
  "mutagen_infos": []
}

NiuXiuHandleType

string

牛宿处理类型（nvxiu: 女宿；douxiu: 斗宿）

枚举值

nvxiudouxiu

示例数据

"nvxiu"

PalaceMutagenItem

object

宫位对应的四化信息

字段定义

star_namestring非空

星曜名称

palace_indexinteger非空

该星耀所在宫位的索引（0-11，从寅宫开始）

mutagen_typestring非空

四化星类型

示例数据

{
  "star_name": "示例名称",
  "palace_index": 0,
  "mutagen_type": "string"
}

Pattern

object

格局对象

字段定义

namestring非空

格局名称

descriptionstring非空

djal51

typestring非空

格局类型：lucky（吉格）/ warning（凶格）/ neutral（默认）

示例数据

{
  "name": "示例名称",
  "description": "string",
  "type": "string"
}

PillarInfo

object

八字四柱信息

字段定义

typeBaziPillarType非空

四柱类型

tgstring非空

天干

dzstring非空

地支

gan_shenstring非空

干神

gan_shen_shortstring非空

干神简称

zhi_shenarray<string>非空

支神

zhi_shen_shortarray<string>非空

支神简称

cang_gan_wxarray<string>非空

藏干*五行

cang_gan_zsarray<string>非空

藏干*支神

na_yinstring非空

纳音

kong_wangstring非空

空亡

di_shistring非空

地势

zi_zuostring非空

自坐

shen_shaarray<string>非空

神煞

示例数据

{
  "type": "natal_year",
  "tg": "string",
  "dz": "string",
  "gan_shen": "string",
  "gan_shen_short": "string",
  "zhi_shen": [
    "string"
  ],
  "zhi_shen_short": [
    "string"
  ],
  "cang_gan_wx": [
    "string"
  ],
  "cang_gan_zs": [
    "string"
  ],
  "na_yin": "string",
  "kong_wang": "string",
  "di_shi": "string",
  "zi_zuo": "string",
  "shen_sha": [
    "string"
  ]
}

PlanetAllowDegree

object

行星相位容许度信息

字段定义

planet_codestring非空

对方行星代码

planet_enstring非空

对方行星英文名

planet_cnstring非空

对方行星中文名

planet_namestring非空

对方行星本地化名称，根据请求的lang参数支持不同语言

planet_fontstring非空

对方行星字体

current_longitudenumber非空

对方行星当前黄道经度

asp_angleinteger非空

相位角度（0, 60, 90, 120, 180）

in_outstring非空

入相/出相（In=入相, Out=出相）

deginteger非空

度

mininteger非空

分

secinteger非空

秒

示例数据

{
  "planet_code": "string",
  "planet_en": "string",
  "planet_cn": "string",
  "planet_name": "示例名称",
  "planet_font": "string",
  "current_longitude": 0,
  "asp_angle": 0,
  "in_out": "string",
  "deg": 0,
  "min": 0,
  "sec": 0
}

PlanetArray

object

宫位内行星信息

字段定义

deginteger非空

度

mininteger非空

分

secinteger非空

秒

longitudenumber非空

行星黄道经度

planet_codestring非空

行星代码

planet_enstring非空

行星英文名

planet_cnstring非空

行星中文名

planet_namestring非空

行星本地化名称，根据请求的lang参数支持不同语言

planet_fontstring非空

行星字体

示例数据

{
  "deg": 0,
  "min": 0,
  "sec": 0,
  "longitude": 0,
  "planet_code": "string",
  "planet_en": "string",
  "planet_cn": "string",
  "planet_name": "示例名称",
  "planet_font": "string"
}

QimenDingJuMethod

string

奇门定局方法（可用取值随起局类型 type 变化，见 QimenQry 校验说明）（chaibu: 拆补；zhirun: 置闰；maoshan: 茅山（茅道）；jinhan: 金函玉镜；traditional: 传统日家；yinpan: 阴盘；not_applicable: 不适用（山向））

枚举值

chaibuzhirunmaoshanjinhantraditionalyinpannot_applicable

示例数据

"chaibu"

QimenFeipanStyle

string

飞盘子流派（仅 pai_method=feipan 时生效，默认 zhigui）（zhigui: 旨归；yinpan: 阴盘；faqiao: 法窍；mingfa: 鸣法；kuonang: 括囊）

枚举值

zhiguiyinpanfaqiaomingfakuonang

示例数据

"zhigui"

QimenMatter

string

奇门择吉用事（12 种；用事权重映射见 select/scoring.MATTER_DOORS / MATTER_STARS）（travel: 出行；wealth: 求财；plan: 谋事；opening: 开业；marriage: 嫁娶；exam: 考试；medical: 求医；lawsuit: 诉讼；moving: 搬家；offspring: 求嗣；trade: 交易；meeting: 会友）

枚举值

travelwealthplanopeningmarriageexammedicallawsuitmovingoffspringtrademeeting

示例数据

"travel"

QimenMount24

string

山向奇门二十四山（JSON 英文小写拼音；癸山丁向 → gui + ding）（ren: 壬；zi: 子；gui: 癸；chou: 丑；gen: 艮；yin: 寅；jia: 甲；mao: 卯；yi: 乙；chen: 辰；xun: 巽；si: 巳；bing: 丙；wu: 午；ding: 丁；wei: 未；kun: 坤；shen: 申；geng: 庚；you: 酉；xin: 辛；xu: 戌；qian: 乾；hai: 亥）

枚举值

renziguichougenyinjiamaoyichenxunsibingwudingweikunshengengyouxinxuqianhai

示例数据

"ren"

QimenPaiPanMethod

string

奇门排盘几何方式（与定局 ju_method 独立；飞盘子流派见 QimenFeipanStyle）（zhuanpan: 转盘；feipan: 飞盘）

枚举值

zhuanpanfeipan

示例数据

"zhuanpan"

QimenQijuType

string

奇门起局类型（rijia: 日家；shijia: 时家；shanxiang: 山向）

枚举值

rijiashijiashanxiang

示例数据

"rijia"

QimenShanBranch

string

山向奇门坐山（十二地支，拼音小写，与 JSON 入参一致）（zi: 子；chou: 丑；yin: 寅；mao: 卯；chen: 辰；si: 巳；wu: 午；wei: 未；shen: 申；you: 酉；xu: 戌；hai: 亥）

枚举值

zichouyinmaochensiwuweishenyouxuhai

示例数据

"zi"

QimenTianqinJiGong

string

转盘天禽星寄宫（山向奇门 zhuanpan 时可选）（kun2: 寄坤二；gen8: 寄艮八；seasonal: 冬至寄艮/夏至寄坤）

枚举值

kun2gen8seasonal

示例数据

"kun2"

QimenYuanSegment

string

山向奇门三元分金（每山 15° 分 shang/zhong/xia 三段，每段 5°）（shang: 上元；zhong: 中元；xia: 下元）

枚举值

shangzhongxia

示例数据

"shang"

QizhengAspectType

string

会合关系。只这三种，不用西洋 60°/90°。（conjunct: 合；trine: 三合；oppose: 冲）

枚举值

conjuncttrineoppose

示例数据

"conjunct"

QizhengChangSheng

string

长生十二神。按年柱纳音安十二宫，每宫一颗；十二支顺行。（changSheng: 长生；muYu: 沐浴；guanDai: 冠带；linGuan: 临官；diWang: 帝旺；shuai: 衰；bing: 病；si: 死；mu: 墓；jue: 绝；tai: 胎；yang: 养）

枚举值

changShengmuYuguanDailinGuandiWangshuaibingsimujuetaiyang

示例数据

"changSheng"

QizhengDignity

string

庙旺地力（对齐 Moira sign_status_seq）：殿垣庙旺乐喜怒；一星可多标。（dian: 殿；yuan: 垣；miao: 庙；wang: 旺；le: 乐；xi: 喜；nu: 怒）

枚举值

dianyuanmiaowanglexinu

示例数据

"dian"

QizhengEarthlyBranch

string

十二地支（与紫微/八字 key 一致）。（zi: 子；chou: 丑；yin: 寅；mao: 卯；chen: 辰；si: 巳；wu: 午；wei: 未；shen: 申；you: 酉；xu: 戌；hai: 亥）

枚举值

zichouyinmaochensiwuweishenyouxuhai

示例数据

"zi"

QizhengHuaYao

string

化曜主名（天禄系）。与十神一一对应；日无化曜。（tianLu: 天禄；tianAn: 天暗；tianFu: 天福；tianHao: 天耗；tianShade: 天荫；tianGui: 天贵；tianXing: 天刑；tianYin: 天印；tianQiu: 天囚；tianQuan: 天权）

枚举值

tianLutianAntianFutianHaotianShadetianGuitianXingtianYintianQiutianQuan

示例数据

"tianLu"

QizhengPalaceKey

string

七政十二宫。偏移 0 为命宫，沿黄经增加（地支递减）。（ming: 命；wealth: 财帛；sibling: 兄弟；property: 田宅；children: 男女；servant: 奴仆；spouse: 夫妻；health: 疾厄；travel: 迁移；career: 官禄；fortune: 福德；appearance: 相貌）

枚举值

mingwealthsiblingpropertychildrenservantspousehealthtravelcareerfortuneappearance

示例数据

"ming"

QizhengPatternType

string

格局吉凶。（lucky: 喜格；warning: 忌格）

枚举值

luckywarning

示例数据

"lucky"

QizhengSpiritStar

string

神煞。安在十二宫地支上；顺序即盘上排列顺序。（tianDe: 天德；yueDe: 月德；tianYi: 天乙；tianGui: 天贵；yuTang: 玉堂；fuXing: 福星；taiJi: 太极；guoYin: 国印；tangFu: 唐符；feiRen: 飞刃；wenChang: 文昌；wenQu: 文曲；tianChu: 天厨；jinYu: 金舆；luShen: 禄勋；suiDian: 岁殿；yiMa: 驿马；taoHua: 桃花；xianChi: 咸池；huaGai: 华盖；jiangXing: 将星；jieSha: 劫煞；wangShen: 亡神；zaiSha: 灾煞；guChen: 孤辰；guaSu: 寡宿；liuHai: 六害；guaQi: 卦气；xueRen: 血刃；fuChen: 浮沉；jieShen: 解神；zhuShou: 注受；huangFan: 黄幡；baoWei: 豹尾；hongLuan: 红鸾；tianXi: 天喜；tianKu: 天哭；piTou: 披头；tianYiXing: 天医；tianShe: 天赦；yangRen: 羊刃；suiJia: 岁驾；jianFeng: 剑锋；fuShi: 伏尸；tianKong: 天空；sangMen: 丧门；diCi: 地雌；guanSuo: 贯索；gouShen: 勾神；feiFu: 飞符；nianFu: 年符；xiaoHao: 小耗；siFu: 死符；daHao: 大耗；suiPo: 岁破；lanGan: 阑干；baoBai: 暴败；ziWei: 紫薇；tianE: 天厄；baiHu: 白虎；tianXiong: 天雄；daSha: 大煞；feiLian: 飞廉；juanShe: 卷舌；jiaoSha: 绞杀；diaoKe: 吊客；tianGou: 天狗；bingFu: 病符；moYue: 蓦越；kongWang: 空亡；sanXing: 三刑；sanTai: 三台；wuGui: 五鬼；baZuo: 八座；zuBao: 卒暴；tunXian: 吞陷；qiuYu: 囚狱；diSang: 地丧；diSha: 地杀；diHao: 地耗；diJie: 地解；tianSha: 天杀；tianHao: 天耗；tianJie: 天解；taiSui: 太岁；taiYang: 太阳；taiYin: 太阴；guXu: 孤虚；xueTang: 学堂；guanFu: 官符；guanGui: 官贵；suiHe: 岁合；nianSha: 年杀；piMa: 披麻；zhiBei: 指背；qingTian: 擎天；douBiao: 斗杓；huiQi: 晦气；yueLian: 月廉；yueSha: 月杀；yueKong: 月空；yueFu: 月符；banAn: 板鞍；liuXia: 流霞；youYi: 游奕；yuGui: 玉贵；deSha: 的杀；poSui: 破碎；fuDe: 福德；fuGui: 福贵；hongYan: 红艳；yinRen: 阴刃；yinSha: 阴杀；longDe: 龙德）

枚举值

tianDeyueDetianYitianGuiyuTangfuXingtaiJiguoYintangFufeiRenwenChangwenQutianChujinYuluShensuiDianyiMataoHuaxianChihuaGaijiangXingjieShawangShenzaiShaguChenguaSuliuHaiguaQixueRenfuChenjieShenzhuShouhuangFanbaoWeihongLuantianXitianKupiToutianYiXingtianSheyangRensuiJiajianFengfuShitianKongsangMendiCiguanSuogouShenfeiFunianFuxiaoHaosiFudaHaosuiPolanGanbaoBaiziWeitianEbaiHutianXiongdaShafeiLianjuanShejiaoShadiaoKetianGoubingFumoYuekongWangsanXingsanTaiwuGuibaZuozuBaotunXianqiuYudiSangdiShadiHaodiJietianShatianHaotianJietaiSuitaiYangtaiYinguXuxueTangguanFuguanGuisuiHenianShapiMazhiBeiqingTiandouBiaohuiQiyueLianyueShayueKongyueFubanAnliuXiayouYiyuGuideShapoSuifuDefuGuihongYanyinRenyinShalongDe

示例数据

"tianDe"

QizhengStarKey

string

十一曜。（sun: 日；moon: 月；mercury: 水（辰星）；venus: 金（太白）；mars: 火（荧惑）；jupiter: 木（岁星）；saturn: 土（镇星）；ketu: 计都（升交点）；rahu: 罗睺（降交点 / 计对点）；yuebei: 月孛（月平远地点）；ziqi: 紫炁）

枚举值

sunmoonmercuryvenusmarsjupitersaturnketurahuyuebeiziqi

示例数据

"sun"

QizhengStarStatus

string

星体状态。接口以列表返回，主状态按逆>留>伏>迟/速/顺取。（retro: 逆；station: 留；combust: 伏；slow: 迟；fast: 速；direct: 顺）

枚举值

retrostationcombustslowfastdirect

示例数据

"retro"

QizhengTenGod

string

化曜十神别名（盘面一字：比劫食伤才财煞官枭印）。（biJian: 比；jieCai: 劫；shiShen: 食；shangGuan: 伤；pianCai: 才；zhengCai: 财；qiSha: 煞；zhengGuan: 官；pianYin: 枭；zhengYin: 印）

枚举值

biJianjieCaishiShenshangGuanpianCaizhengCaiqiShazhengGuanpianYinzhengYin

示例数据

"biJian"

QizhengWuXing

string

五行（恩用仇难、度主折算后）。（wood: 木；fire: 火；earth: 土；metal: 金；water: 水）

枚举值

woodfireearthmetalwater

示例数据

"wood"

QizhengXiuKey

string

二十八宿。key 避开与地支 zi/shen/wei/bi 的冲突。（jiao: 角；kang: 亢；di: 氐；fang: 房；xin: 心；wei: 尾；ji: 箕；dou: 斗；niu: 牛；nu: 女；xu: 虚；weiXiu: 危；shi: 室；bi: 壁；kui: 奎；lou: 娄；weiTu: 胃；mao: 昴；biYue: 毕；zui: 觜；shenXiu: 参；jing: 井；gui: 鬼；liu: 柳；xing: 星；zhang: 张；yi: 翼；zhen: 轸）

枚举值

jiaokangdifangxinweijidouniunuxuweiXiushibikuilouweiTumaobiYuezuishenXiujingguiliuxingzhangyizhen

示例数据

"jiao"

QizhengXiuLord

string

宿的度主（木金土日月火水循环）。日月度主在恩用仇难中分别按火、水论。（wood: 木；metal: 金；earth: 土；sun: 日；moon: 月；fire: 火；water: 水）

枚举值

woodmetalearthsunmoonfirewater

示例数据

"wood"

QizhengXiuRuler

string

二十八宿尺：今宿（默认）/ 古宿量天尺。（ancient: 古宿；modern: 今宿（Moira 距星））

枚举值

ancientmodern

示例数据

"ancient"

QizhengZodiac

string

黄道：回归 / 恒星。计算暂只实现 tropical。（tropical: 回归黄道；sidereal: 恒星黄道）

枚举值

tropicalsidereal

示例数据

"tropical"

Section

object

段落

字段定义

titlestring非空

段落标题

contentstring非空

段落内容

示例数据

{
  "title": "string",
  "content": "string"
}

SignGuardian

object

星座守护星信息

字段定义

planet_codestring非空

行星代码

planet_enstring非空

行星英文名

planet_cnstring非空

行星中文名

planet_namestring非空

行星本地化名称，根据请求的lang参数支持不同语言

planet_fontstring非空

行星字体

示例数据

{
  "planet_code": "string",
  "planet_en": "string",
  "planet_cn": "string",
  "planet_name": "示例名称",
  "planet_font": "string"
}

SignInfo

object

星座信息

字段定义

deginteger非空

度

mininteger非空

分

secinteger非空

秒

sign_idinteger非空

星座ID

sign_enstring非空

星座英文名

sign_cnstring非空

星座中文名

sign_namestring非空

星座本地化名称，根据请求的lang参数支持不同语言

sign_fontstring非空

星座字体

示例数据

{
  "deg": 0,
  "min": 0,
  "sec": 0,
  "sign_id": 0,
  "sign_en": "string",
  "sign_cn": "string",
  "sign_name": "示例名称",
  "sign_font": "string"
}

SignPlanet

object

星座内行星信息

sign_id / sign_en / sign_cn / sign_font 已废弃，请使用外层 SignVo 的对应字段。

字段定义

planet_codestring非空

行星代码

planet_enstring非空

行星英文名

planet_cnstring非空

行星中文名

planet_namestring非空

行星本地化名称，根据请求的lang参数支持不同语言

longitudenumber非空

行星黄道经度

house_idinteger非空

行星所在宫位ID

speednumber非空

行星速度

planet_fontstring非空

行星字体

deginteger非空

度

mininteger非空

分

secinteger非空

秒

示例数据

{
  "planet_code": "string",
  "planet_en": "string",
  "planet_cn": "string",
  "planet_name": "示例名称",
  "longitude": 0,
  "house_id": 0,
  "speed": 0,
  "planet_font": "string",
  "deg": 0,
  "min": 0,
  "sec": 0
}

Star

object

星曜对象

字段定义

namestring非空

星曜名称

typestring非空

星曜类型：'major', 'soft', 'tough', 'adjective', 'flower', 'helper', 'lucun', 'tianma', 'boshi', 'suiqian', 'jiangqian', 'dynamic'

brightnessstring | null

星曜亮度

示例数据

{
  "name": "示例名称",
  "type": "string",
  "brightness": "string"
}

StarInterpretation

object

星耀落宫解读对象

字段定义

star_namestring非空

星耀名称

palace_namestring非空

宫位名称

interpretationstring非空

解读内容

示例数据

{
  "star_name": "示例名称",
  "palace_name": "示例名称",
  "interpretation": "string"
}

StarWithMutagen

object

星曜对象（包含四化信息）

字段定义

namestring非空

星曜名称

typestring非空

星曜类型：'major', 'soft', 'tough', 'adjective', 'flower', 'helper', 'lucun', 'tianma', 'boshi', 'suiqian', 'jiangqian', 'dynamic'

brightnessstring | null

星曜亮度

transform_typesarray<TransformInfo>

四化星变换类型

示例数据

{
  "name": "示例名称",
  "type": "string",
  "brightness": "string",
  "transform_types": [
    {
      "mutagen_type": "string",
      "transform_type": "self"
    }
  ]
}

SvgType

string

SVG 图表类型（Default: 默认盘；Pro: 专业盘；NoDisplay: 不显示盘）

枚举值

DefaultProNoDisplay

示例数据

"Default"

TimeAndLocation

object

时间地点信息

字段定义

birth_dtstring非空

日期时间字符串（出生时间、推运时间或查询时间），格式为1999-10-17 21:00:00

tzinteger

时区

默认值: 8

longitudenumber非空

经度

latitudenumber非空

纬度

dst_autoboolean

是否自动进行夏令时校正(仅对中国大陆地区有效)

默认值: true

示例数据

{
  "birth_dt": "1999-10-17 21:00:00",
  "tz": 8,
  "longitude": 116.4074,
  "latitude": 39.9042,
  "dst_auto": true
}

TransformInfo

object

四化星变换类型

字段定义

mutagen_typestring非空

四化星类型

transform_typeTransformType非空

四化星变换类型

示例数据

{
  "mutagen_type": "string",
  "transform_type": "self"
}

TransformType

string

紫微斗数四化类型（按天干分类）

枚举值

selfoppositeother

示例数据

"self"

ValidationError

object

字段定义

locarray<string | integer>非空

msgstring非空

typestring非空

示例数据

{
  "loc": [
    null
  ],
  "msg": "string",
  "type": "string"
}

WxInfo

object

五行信息

字段定义

wxstring非空

五行

is_day_masterboolean非空

是否为日主

rationumber非空

比例

shi_shenarray<string>非空

十神

示例数据

{
  "wx": "string",
  "is_day_master": true,
  "ratio": 0,
  "shi_shen": [
    "string"
  ]
}

ZiweiAuxStarFlyIn

object

生年干禄存/擎羊/陀罗落入对方宫位

字段定义

star_namestring非空

星曜 stable key：lucunMin/qingyangMin/tuoluoMin

palace_namestring非空

落入对方宫位 stable key

palace_indexinteger非空

落入对方宫位索引（0-11，从寅起）

earthly_branchstring

落入宫位地支 stable key

默认值: ""

示例数据

{
  "star_name": "示例名称",
  "palace_name": "示例名称",
  "palace_index": 0,
  "earthly_branch": ""
}

ZiweiFlyInItem

object

生年干四化落入对方宫位

字段定义

mutagen_typestring非空

四化类型：sihuaLu/sihuaQuan/sihuaKe/sihuaJi

star_namestring非空

被化星曜 stable key

palace_namestring非空

落入对方宫位 stable key；未找到时为空

palace_indexinteger非空

落入对方宫位索引（0-11，从寅起）；未找到时为 -1

earthly_branchstring

落入宫位地支 stable key

默认值: ""

示例数据

{
  "mutagen_type": "string",
  "star_name": "示例名称",
  "palace_name": "示例名称",
  "palace_index": 0,
  "earthly_branch": ""
}