西方占星-次限盘
文档说明
西占次限盘是按 “出生一日对应人生一年” 推演形成的星盘，通过与本命盘的相位互动，解读个人长期内在成长与人生阶段基调，是判断人生长期发展脉络的占星方法。
- 自动时区与夏令时（DST）处理： 开发者只需传入 IANA 标准时区（如
Asia/Shanghai），接口将自动检索全球历史时区数据库，完美处理不同年份的夏令时偏移，无需手动换算 UTC。 - 关于真太阳时： 西方占星基于绝对 UTC 时间与地理坐标计算恒星时，
无需额外计算真太阳时。请勿将换算后的真太阳时带入接口，以免造成坐标偏差。 - 高性能数据压缩支持： 强烈建议在生产环境开启
compress=1接口将采用标准 GZIP 算法压缩报文，可大幅缩减报文体积，显著提升接口响应速度，并节省服务器外网带宽成本。 - 多维度数据输出： 接口不仅返回原始的 JSON 坐标数据，还同步下发高解析度的 SVG 矢量星盘图，支持前端直接渲染。点击 此处 访问
前端星盘SVG渲染开发文档 - 标准化数据映射： 为了确保前后端逻辑的严精对接，接口返回的所有天体代码、相位类型、星座 ID 及宫位主题均采用标准化的数值枚举。点击 此处 访问
数据集合 - 西方占星枚举表
请求方式
POST
GET
https://api.yuanfenju.com/index.php/v1/Astrology/secondaryprogression请求头
| 字段 | 类型 | 描述 |
|---|---|---|
| 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女 |
| target_year | Int | 公历推运年 例: 1988 |
| target_month | Int | 公历推运月 例: 8 |
| target_day | Int | 公历推运日 例: 7 |
| target_hours | Int | 公历推运时(0-23) 例: 12 |
| target_minute | Int | 公历推运分 (0-59) 例: 30 如果不知道具体分，可以传数字 0 |
| 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 | 容许度模型，例：5
非必传，默认 5
支持参数：1:严格, 2:标准, 3:宽泛, 4:自定义, 5:推运专用(全相位1度默认)
|
| 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 非必传，如果不传递这个参数，默认为 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,
'target_year' => '2025',
'target_month' => '11',
'target_day' => '8',
'target_hours' => '12',
'target_minute' => '20',
'longitude' => '116.407396',
'latitude' => '39.904200',
'timezone' => 'Asia/Shanghai',
'house_system' => 'P',
'additional_objects' => '1,2,7', // 开启宿命点、凯龙星、福点
'orb_model' => '5',
'compress' => '1' // 开启数据压缩以提高传输速度返回参数
| 字段 | 类型 | 描述 |
|---|---|---|
| errcode | String | 请求状态码 0成功 其它为失败 |
| errmsg | String | 状态码说明 |
| notice | String | 声明 |
| data | Json | 数据信息 |
成功返回示例
为了方便开发者快速构建数据模型，以下是完整的核心 JSON 结构说明（已折叠重复的数组项）：
{
"errcode": 0, // 状态码：0代表成功
"errmsg": "请求成功",
"notice": "本次测算结果仅供娱乐使用...",
"data": {
"base_info": { // 基础排盘参数
"chart_type": "secondary_progression", // 星盘类型：secondary_progression (次限推运盘固定值)
"natal_info": { // 本命出生信息 (B盘底盘)
"gender": "male", //性别(male男/female女)
"birthday": "2026-3-28 9:32:00",// 出生时间
"longitude": 116.4224,// 出生十进制经度
"latitude": 39.9348,// 出生十进制纬度
"timezone": "Asia/Shanghai",// IANA时区
"house_system": "P",// 宫位制代码(P=普拉西度制)
"numerology": "5" // 核心命理：西方生命密码/生命灵数(1-9)
},
"target_info": { // 次限目标时间/地点信息 (A盘次限)
"gender": "male", // 占位字段，推运计算不使用，保持结构一致
"birthday": "2026-3-28 9:32:00",// 推运目标时刻
"longitude": 116.42240097766,// 推运目标地点经度（默认同本命）
"latitude": 39.934827272396, // 推运目标地点纬度（默认同本命）
"timezone": "Asia\/Shanghai", // 推运目标时区（默认同本命）
"house_system": "P", // 宫位制代码（默认同本命）
"numerology": "5" // 占位字段，推运计算不使用
}
},
"detail_info": {
"chart_data": { // 核心测算结果集合
// ================= 1. 推运次限+本命盘基础数据 (A方为次限推演层，B方为本命底盘) =================
"person_a_natal": { ... }, // 推运次限除了 patternData 之外的完整数据，包含 housesData/signData/planetData/attributeData，结构同本命盘接口，可参考本命盘数据，此处省略以节省篇幅。
"person_b_natal": { ... }, // 本命盘底除了 patternData 之外的完整数据，结构同上。
// ================= 2. 次限对本命的深度触发数据 (复用双盘比对结构) =================
"synastry": {
"meta": { // 比对数据复杂度元统计
"object_count_a": 14, // 推运次限启用的星体与虚点总数
"object_count_b": 14, // 本命底盘启用的星体与虚点总数
"planet_aspect_count": 34, // 推运次限与本命星构成的有效交角总数
"house_overlay_count": 28 // 推运次限落入本命宫位的总数
},
"planet_aspects": [ // 次限星体与本命星体形成的触发相位列表
{
"from": "A_0", // 发起方标识：A方推运次限太阳 (A_后面跟星体的唯一识别码 code_name)，枚举值请参阅 [数据集合-西方占星-code_name]
"to": "B_6", // 接收方标识：B方本命土星 (B_后面跟星体的唯一识别码 code_name)，枚举值请参阅 [数据集合-西方占星-code_name]
"planet_a": { // 次限星体及状态 (Transit)
"code_name": "0", //星体的唯一标识符，枚举值请参阅 [数据集合-西方占星]
"planet_english": "Sun", //星体英文名，枚举值请参阅 [数据集合-西方占星]
"planet_chinese": "太阳", //星体中文名，枚举值请参阅 [数据集合-西方占星]
"planet_chinese_traditional": "太陽", //星体繁体中文名，枚举值请参阅 [数据集合-西方占星]
"planet_font": "Su",//星体图标映射码，枚举值请参阅 [数据集合-西方占星]
"longitude": 6.405695,// 绝对经度
"speed": 0.9899524, //运行速度，枚举：正数代表非逆行，负数代表逆行，null代表不适用
"is_retrograde": false, // 是否逆行标识，枚举：true代表逆行，false代表非逆行
"sign": { // 该星体所在星座信息
"deg": 6, "min": 24, "sec": 21, //星体所在星座精准度、分、秒
"sign_id": 0, /// 星座系统编号(0-11)
"sign_english": "Aries",
"sign_chinese": "白羊",
"sign_chinese_traditional": "白羊",
"sign_font": "A" //星座图标映射码，枚举值请参阅 [数据集合-西方占星]
}
},
"planet_b": { // 被触发的本命星体及状态
"code_name": "6",
"planet_english": "Saturn",
"planet_chinese": "土星",
"planet_chinese_traditional": "土星",
"planet_font": "Sa",
"longitude": 4.9334618,
"speed": 0.1248473,
"is_retrograde": false,
"sign": {
"deg": 4, "min": 56, "sec": 0,
"sign_id": 0,
"sign_english": "Aries",
"sign_chinese": "白羊",
"sign_chinese_traditional": "白羊",
"sign_font": "A"
}
},
"aspect": { // 形成的具体相位信息
"allow": 0, // 发生相位的基准角度 (0/30/60/90/120/150/180)
"aspect_english": "Conjunction",//相位英文名，枚举值请参阅 [数据集合-西方占星]
"aspect_chinese": "合相", //相位中文名，枚举值请参阅 [数据集合-西方占星]
"aspect_chinese_traditional": "合相",//相位繁体中文名，枚举值请参阅 [数据集合-西方占星]
"orb": 1.4722332, // 容许度误差 (实际角度差与基准角度的偏差度数)
"deg": 0, //容许度误差转化为度结构
"min": 0, //容许度误差转化为分结构
"sec": 0, //容许度误差转化为秒结构
"in_out": "0", // "1"代表入相(能量渐强), "-1"代表出相(能量渐弱), "0"代表无
"type": "positive", // 相位性质 (positive积极/challenging挑战/neutral中性)
"strength": 0.836, // 相位综合能量强度得分，取值范围 [0.05, 2.0]。值越大代表相位能量越强（前端可根据此值域，使用插值算法动态调节连线的粗细或不透明度，例如：1.5以上画粗实线，0.5以下画细虚线）。
"polarity": "fusion" // 相位语义极性分类 (fusion强烈融合/flow和谐流动/friction冲突成长/integrative_tension整合张力)
}
}
// ... 其他几十组相位数据省略 ...
],
"aspect_links": [ // 相位连线精简数据集合 (供前端可视化连线直接使用)
{
"from": "A_0",
"to": "B_6",
"aspect": "Conjunction",
"type": "positive",
"orb": 1.4722332,
"in_out": "-1",
"strength": 0.836,
"polarity": "fusion"
}
],
"house_overlay_a_in_b": [ // 次限星体过境本命宫位数据(外圈 次限 影响内圈 本命 )
{
"planet": { // 正在过境的次限星体 (A方)
"code_name": "0", //星体的唯一标识符，枚举值请参阅 [数据集合-西方占星]
"planet_english": "Sun",
"planet_chinese": "太阳",
"planet_chinese_traditional": "太陽",
"planet_font": "Su",
"longitude": 6.405695,
"speed": 0.9899524,
"is_retrograde": false,
"sign": {
"deg": 6,
"min": 36,
"sec": 23,
"sign_id": 0,
"sign_english": "Aries",
"sign_chinese": "白羊",
"sign_chinese_traditional": "白羊",
"sign_font": "A"
}
},
"house_id": 11, // 被触发的本命具体宫位 ID，枚举：1～12
"house_name": "福德宫", // 本命宫位含义
"relative_deg": 10.2035627, // 在该本命宫位内的相对偏移度数
"relative_dms": { "deg": 10, "min": 12, "sec": 13 }, // 相对偏移换算的度分秒
"house_theme": "friends_hopes", // 宫位主管主题方向，枚举值请参阅 [数据集合-西方占星]
"house_weight": 1, // 宫位先天影响力权重，取值范围 [1.0, 1.4]，枚举值请参阅 [数据集合-西方占星]
"overlay_strength": 1.43, // 次限星对该宫位的能量激活得分，取值范围 [0.57, 2.0]。值越大代表该次限星对现实领域的干预越强。
"house_focus_level": "high" // 次限焦点等级 (high高/medium中/low低)
}
// ... 次限其他星体的过宫数据省略 ...
],
"house_overlay_b_in_a": [], //【重要】本命星体落入次限宫位在占星学中缺乏实际参考意义，此处固定为空数组以保持接口结构统一。
"angle_contacts": [ // 四轴与敏感点的触发（次限触发本命轴点，或次限轴点触发本命星）
{
"type": "A_angle_to_B_planet", //触发方向标识，枚举值："A_angle_to_B_planet" 触发方向标识："A_angle_to_B_planet" (次限四轴扫过本命星)，"B_angle_to_A_planet" (次限星体触碰本命四轴)
"angle_english": "Ascendant", //四轴/敏感点信息英文名，枚举值：Ascendant//Midheaven/ImumCoeli/Descendant/Vertex
"angle_chinese": "上升", //四轴/敏感点信息中文名，枚举值：上升/天顶/天底/下降/宿命点
"angle_chinese_traditional": "上升點", //四轴/敏感点信息繁体中文名，枚举值：上升點/天頂/天底/下降點/宿命點
"planet_english": "Sun", //星体英文名称，枚举值请参阅 [数据集合-西方占星]
"planet_chinese": "太阳", //星体中文名称，枚举值请参阅 [数据集合-西方占星]
"planet_chinese_traditional": "太陽", //星体繁体中文名称，枚举值请参阅 [数据集合-西方占星]
"allow": 90, // 发生相位的基准角度 (0/30/60/90/120/150/180)
"aspect_english": "Square", //相位英文名，枚举值请参阅 [数据集合-西方占星]
"aspect_chinese": "四分相", //相位中文名，枚举值请参阅 [数据集合-西方占星]
"aspect_chinese_traditional": "四分相", //相位繁体中文名，枚举值请参阅 [数据集合-西方占星]
"orb": 5.7248766, // 容许度误差 (实际角度差与基准角度的偏差度数)
"deg": 5, "min": 43, "sec": 30, //误差换算 度分秒
"in_out": "0", // "1"代表入相(能量渐强), "-1"代表出相(能量渐弱), "0"代表无，注意：因为四轴是数学虚点没有物理运行速度，所以在 angle_contacts 中该字段永远固定输出 "0"
"aspect_type": "challenging", //相位吉凶属性，枚举值：positive(和谐)/challenging(挑战)/neutral(中性)，可参阅 [数据集合-西方占星]
"strength": 0.054, //相位综合强度得分，浮点数，范围通常在 0.05 ~ 2.0 之间。低于 0.05 的噪音已被过滤，分数越高说明该触发现象在关系中越震撼/宿命。
"polarity": "neutral" //能量极性/语义标签，用于辅助解读器或前端生成更细腻的文案，枚举值：fusion/integrative_tension/flow/friction/neutral，可参阅 [数据集合-西方占星]
}
// ... 其它相位互动数据省略 ...
],
}
},
// ================= 专业文案与高精渲染图 =================
"chart_description": { // 多维度结构化解析文案（内容根据请求参数 lang 自动切换 zh-cn/zh-tw/en-us）
"summary": [ // 【数组】次限盘整体基调与核心议题
{
"target": "次限演化基调：太阳落入白羊座",
"description": "次限太阳进入白羊座，你正步入一个长达三十年的全新开创期..."
}
],
"houses": [ // 【数组】次限盘宫头落入星座的解析
{
"target": "次限水星落入本命第8宫",
"description": "次限水星推进本命第八宫，思维进入了深度侦查与转化的模式..."
}
],
"planets": { // 【对象】个性的深度解析
"sign": [ // 次限落入星座的解析（行为模式/性格特质）
{
"target": "次限水星落入双鱼座",
"description": "次限水星进入双鱼座，逻辑消融在诗意与直觉中。你可能感到思维不再清晰..."
},
{
"target": "次限金星落入白羊座",
"description": "次限金星进入白羊座，你的情感世界被注入了新的活力。在爱与审美上..."
}
// ... 其他行星落座解析省略 ...
],
"house": [], //【重要】次限盘此处文案无意义，固定为空数组
},
"aspects": [ // 【数组】次限盘重要相位的深度互动解析
{
"target": "次限太阳 合相 本命太阳",
"description": "次限太阳合相本命太阳，生命进入全新的三十年轮回，这是身份认同的终极重塑..."
}
],
"angles": [ // 【数组】次限盘四轴点(Asc/Mc/Ic/Dsc)相位解析
{
"target": "次限太阳 三分相 本命上升",
"description": "次限太阳三合本命上升，自我能量与外在展现形成流畅的正向联结，个人..."
}
]
},
// 推运盘高精度星盘矢量图源码(详见前端SVG图片开发文档)
"chart_svg": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<svg width=\"720\" height=\"720\" ...>...</svg>"
}
}
}
失败返回示例
{
"errcode": -1,
"errmsg": "经度必须在 -180 ~ 180 之间"
}