西方占星-法达星限
文档说明
法达星限（Firdaria）是古典西方占星学中极其严谨的分时大运体系。系统首先采用黄道几何地平算法判定盘主为日生盘（Day Chart）或夜生盘（Night Chart），进而分配不同的七政星体执政序列，展开为期 75 年的人生大运与子运时间轴。接口内部自动匹配盘主当前的自然年龄，精准锁定当前正在走的大限主星与子运主星，深度剖析当事人当下的运势主题、财富事业发力点与潜伏挑战。
- 自动时区与夏令时（DST）处理： 开发者只需传入 IANA 标准时区（如
Asia/Shanghai），接口将自动检索全球历史时区数据库，完美处理不同年份的夏令时偏移，无需手动换算 UTC。 - 关于真太阳时： 西方占星基于绝对 UTC 时间与地理坐标计算恒星时，
无需额外计算真太阳时。请勿将换算后的真太阳时带入接口，以免造成坐标偏差。 - 高性能数据压缩支持： 强烈建议在生产环境开启
compress=1接口将采用标准 GZIP 算法压缩报文，可大幅缩减报文体积，显著提升接口响应速度，并节省服务器外网带宽成本。 - 多维度数据输出： 接口不仅返回原始的 JSON 坐标数据，还同步下发高解析度的 SVG 矢量星盘图，支持前端直接渲染。点击 此处 访问
前端星盘SVG渲染开发文档 - 标准化数据映射： 为了确保前后端逻辑的严谨对接，接口返回的所有天体代码、相位类型、星座 ID 及宫位主题均采用标准化的数值枚举。点击 此处 访问
数据集合 - 西方占星枚举表
请求方式
POST
GET
https://api.yuanfenju.com/index.php/v1/Astrology/firdaria请求头
| 字段 | 类型 | 描述 |
|---|---|---|
| Content-Type | String | application/x-www-form-urlencoded |
请求参数
| 字段 | 类型 | 描述 |
|---|---|---|
| api_key | String | 密钥 |
| year | Int | 公历出生年 例: 1988 |
| month | Int | 公历出生月 例: 8 |
| day | Int | 公历出生日 例: 7 |
| hours | Int | 公历出生时(0-23) 例: 12 |
| minute | Int | 公历出生分 (0-59) 例: 30 如果不知道具体分，可以传数字 0 |
| sex | Int | 性别 0男 1女 |
| longitude | Float | 出生十进制经度 例：-77.036871 非必传，默认北京经度。 |
| latitude | Float | 出生十进制纬度 例：38.907192 非必传，默认北京纬度。 |
| timezone | String |
时区（IANA 格式），例：Asia/Shanghai
非必传，默认 Asia/Shanghai
|
| house_system | String | 宫位制代码 例：P
非必传，默认 P
支持参数：P, K, O, R, C, A, E, W, T, M, B, X, V |
| additional_objects | String | 附加星体及虚点，英文逗号分隔，如：1,2,7
非必传，默认空
支持的编号：
1(宿命点 Vertex), 2(凯龙星 Chiron), 3(谷神星 Ceres), 4(智神星 Pallas), 5(婚神星 Juno), 6(灶神星 Vesta), 7(福点 Part of Fortune), 8(真交点 true Node), 9(平莉莉丝 mean Lilith), 10(普赛克 Psyche), 11(厄洛斯 Eros), 12(妊神星 Haumea), 13(阋神星 Eris), 14(鸟神星 Makemake), 15(平交点 mean Node), 16(南交点 south Node)。 |
| orb_model | Int | 容许度模型，例：2
非必传，默认 2
支持参数：1:严格(偏小), 2:标准(默认), 3:宽泛(偏大), 4:自定义
|
| orb_conjunction | Float | 合相 (0°) 容许度，例：8 当 orb_model=4 时生效。 非必传，默认 8
|
| orb_semisextile | Float | 半六分相 (30°) 容许度，例：2 当 orb_model=4 时生效。 非必传，默认 2
|
| orb_sextile | Float | 六分相 (60°) 容许度，例：6 当 orb_model=4 时生效。 非必传，默认 6
|
| orb_square | Float | 四分相 (90°) 容许度，例：6 当 orb_model=4 时生效。 非必传，默认 6
|
| orb_trine | Float | 三分相 (120°) 容许度，例：6 当 orb_model=4 时生效。 非必传，默认 6
|
| orb_quincunx | Float | 梅花相 (150°) 容许度，例：3 当 orb_model=4 时生效。 非必传，默认 3
|
| orb_opposition | Float | 对分相 (180°) 容许度，例：8 当 orb_model=4 时生效。 非必传，默认 8
|
| lang | String | 多语言：zh-cn 、zh-tw、en-us 非必传，如果不传递这个参数，默认为 zh-cn |
| compress | Int | 是否开启数据压缩(标准压缩模式)。例：1：开启 2：关闭
非必传，如果不传递该参数，默认值为 2（返回纯文本 JSON）。
|
请求参数示例
$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'year' => '1988',
'month' => '11',
'day' => '8',
'hours' => '12',
'minute' => '20',
'sex' => 1,
'longitude' => '116.407396',
'latitude' => '39.904200',
'timezone' => 'Asia/Shanghai',
'house_system' => 'P',
'additional_objects' => '1,2,7', // 开启宿命点、凯龙星、福点
'orb_model' => '2',
'compress' => '1', // 开启数据压缩以提高传输速度
];返回参数
| 字段 | 类型 | 描述 |
|---|---|---|
| errcode | String | 请求状态码 0成功 其它为失败 |
| errmsg | String | 状态码说明 |
| notice | String | 声明 |
| data | Json | 数据信息 |
成功返回示例
为了方便开发者快速构建数据模型，以下是完整的核心 JSON 结构说明（已折叠重复的数组项）：
{
"errcode": 0, // 状态码：0代表成功，其他代表失败
"errmsg": "请求成功", // 状态说明
"notice": "本次测算结果仅供娱乐使用...",
"data": {
"base_info": { // 基础排盘参数
"chart_type": "firdaria", // 星盘类型：firdaria (法达星限固定值)
"is_day_chart": true, // 昼夜盘判定：true 代表日生盘，false 代表夜生盘
"chart_sect": "Day (日生盘)", // 昼夜盘文字描述（支持多语言）
"current_period": { // ⭐ 系统精准锁定的当事人【当前正在走】的大限与子运
"major": { // 当前大限主星
"planet": "Sun",
"planet_english": "Sun",
"planet_chinese": "太阳",
"planet_chinese_traditional": "太阳",
"start_time": "2026-03-27 20:03:00", // 当前大限起算时间
"end_time": "2036-03-27 20:03:00" // 当前大限结束时间
},
"sub": { // 当前子运星
"sub_planet": "Venus",
"planet_english": "Venus",
"planet_chinese": "金星",
"planet_chinese_traditional": "金星",
"start_time": "2026-03-27 20:03:00",
"end_time": "2027-08-28 17:08:34"
}
},
"natal_info": { // 盘主本命基础信息
"gender": "male",
"birthday": "1988-11-8 12:20:00",
"longitude": 116.407396,
"latitude": 39.904200,
"timezone": "Asia/Shanghai",
"house_system": "P",
"numerology": "4"
}
},
"detail_info": { // 核心排盘数据与解析
// ================= 1. 法达 75 年大限与子运完整时间轴 =================
"firdaria_timeline": [ // 75年大运时间轴完整集合
{
"major_planet": "Sun", // 大运主星代码
"planet_english": "Sun",
"planet_chinese": "太阳",
"planet_chinese_traditional": "太阳",
"years": 10, // 掌管年限 (日生盘太阳管10年)
"start_time": "2026-03-27 20:03:00", // 本大限开始时间
"end_time": "2036-03-27 20:03:00", // 本大限结束时间
"sub_periods": [ // 该大限内部细分的 7 个子运区间
{
"sub_planet": "Sun",
"planet_english": "Sun",
"planet_chinese": "太阳",
"planet_chinese_traditional": "太阳",
"start_time": "2026-03-27 20:03:00",
"end_time": "2027-08-28 17:08:34"
},
{
"sub_planet": "Venus",
"planet_english": "Venus",
"planet_chinese": "金星",
"planet_chinese_traditional": "金星",
"start_time": "2027-08-28 17:08:34",
"end_time": "2029-01-29 02:17:08"
}
// ... 其余子运区间省略 ...
]
}
// ... 其余大限阶段省略 (金星8年、水星13年、月亮9年等，共计75年) ...
],
// ================= 2. 本命星盘核心天象数据 =================
"chart_data": { // 盘主本命单盘数据，法达算法依此评估大运主星落座、落宫与受克状态
"housesData": [ ... ],
"signData": [ ... ],
"planetData": [ ... ],
"attributeData": { ... },
"patternData": [ ... ]
},
// ================= 3. 法达大运专属解析文案 =================
"chart_description": { // 多维度大运解析（根据请求参数 lang 自动切换 zh-cn/zh-tw/en-us）
"summary": [ // 【数组】法达大运总纲（日生/夜生大运总论）
{
"target": "日生盘法达大运总纲",
"description": "太阳为主导星的日生盘，人生发展往往依托于个人目标、名誉声望与自我意志的显化..."
}
],
"houses": [], // 【重要】法达不解读静态宫头，置空占位
"planets": { // 【对象】法达大运核心星体落座与落宫深度解读
"sign": [
{
"target": "大运星【太阳】落入天蝎座",
"description": "当行至太阳大运时，太阳落入天蝎座意味着这个阶段充满深刻蜕变与意志考验..."
}
],
"house": [
{
"target": "大运星【太阳】落入第8宫",
"description": "太阳行运掌管第八宫生活领域，此阶段焦点涉及财务整合、共有资产及深刻危机转化..."
}
]
},
"angles": [], // 【重要】法达不看四轴大运，置空占位
"aspects": [ // 【数组】大运主星与本命盘其他主星的相位联动（判定运势阻力与助力）
{
"target": "太阳 合相 土星",
"description": "大运主星太阳遇土星合相，代表该运程期内责任重大，需脚踏实地累积，方能化阻力为成就..."
}
]
},
"chart_svg": "<svg>...</svg>" // 高精度星盘矢量图源码(详见前端SVG图片开发文档)
}
}
}失败返回示例
{
"errcode": -1,
"errmsg": "经度必须在 -180 ~ 180 之间"
}