数据结构 - ApiWorks

数据结构总览

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

20

请求对象

64

响应对象

60

其他数据模型

请求对象

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

BaziFlowQry

八字流盘查询请求

字段定义

langstring

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

默认值: "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

目标日期时间（可选），格式：'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",
  "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 等

默认值: "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 等

默认值: "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"
}

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"

示例数据

{
  "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"
}

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"
}

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"
}

ZiweiNatalQry

紫微斗数本命盘查询参数

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

字段定义

langstring

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

默认值: "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 等

默认值: "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[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[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[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[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
    }
  ]
}

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"
}

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
  ]
}

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"
    }
  ]
}

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"
  ]
}

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"

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"

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"
  ]
}