2026-03-21 20:10:57 标签：技术教程 作者：缘份居
八字专业排盘API在传统殡葬/祭祀服务平台中，其核心作用是依据逝者或用户的生辰信息，精准计算出命盘、大运、神煞等关键数据，为后续的择选下葬吉日、确定风水穴位朝向等专业服务提供不可替代的底层命理学数据支撑。
请求地址：https://api.yuanfenju.com/index.php/v1/Bazi/paipan
请求方式：POST
Header：Content-Type: application/x-www-form-urlencoded
核心参数（均为字符串类型）：
- api_key (必填)：你的接口密钥。
- name (必填)：姓名。
- sex (必填)：性别，"男" 或 "女"，用于排大运。
- type (必填)："1" 代表输入为公历，"2" 代表输入为农历。
- year, month, day, hours, minute (必填)：年月日时分。
- zhen (可选)：真太阳时校准，格式为 "经度,纬度"，例如 "116.4,39.9"。
- sect (可选)：子时流派，"1" 为晚子时日柱按当天，"2" 为晚子时日柱按次日。
以下是使用 Axios 封装的 Node.js 请求函数，开箱即用。
const axios = require('axios');
const qs = require('querystring');
async function getBaziPan() {
const url = 'https://api.yuanfenju.com/index.php/v1/Bazi/paipan';
const params = {
api_key: 'YOUR_API_KEY_HERE', // 替换为你的真实api_key
name: '张三',
sex: '男',
type: '1', // 1公历
year: '1950',
month: '3',
day: '15',
hours: '12',
minute: '30',
zhen: '116.4,39.9', // 可选，北京经纬度真太阳时校准
sect: '1' // 可选，晚子时流派
};
try {
const response = await axios.post(url, qs.stringify(params), {
headers: {
'Content-Type': 'application/x-www-form-urlencoded'
}
});
console.log('接口响应成功：', response.data);
return response.data;
} catch (error) {
console.error('接口请求失败：', error.response ? error.response.data : error.message);
throw error;
}
}
// 执行函数
// getBaziPan();接口成功将返回一个结构极其丰富的 JSON 对象。这里挑两个在择吉业务中最关键的数据字段进行解析。
a) 大运列表 (dayun): 这是一个数组，包含了命主一生所行的大运。每步大运包含起运年龄、干支、十神等信息。在择吉日中，我们需要结合当前或未来的大运五行来挑选最有利的时日。
// 假设返回数据为 res
const daYunList = res.data.dayun; // 获取大运数组
// 示例：提取第一步大运的干支和起运年龄
const firstDaYun = daYunList[0];
console.log(`起运：${firstDaYun.start}岁，大运：${firstDaYun.ganzhi}`);
// 输出可能为：起运：7岁，大运：庚寅b) 流年信息 (liunian): 这是一个对象，通常以当前或指定年份的干支为键。它详细列出了该年的神煞、十神作用等信息。这是判断某一年是否适合进行安葬、祭祀等重大活动的直接依据。
// 获取特定年份（例如2024甲辰年）的流年详情
const liuNianInfo = res.data.liunian['2024']; // 注意键名是字符串
if (liuNianInfo) {
console.log(`2024年神煞：${liuNianInfo.shensha.join(', ')}`);
console.log(`2024年十神：${liuNianInfo.shishen}`);
// 根据神煞和十神判断吉凶，集成到业务逻辑中
}通过调用此 API，你的平台无需研究复杂的紫微斗数或子平八字算法，直接获得结构化结果，将开发重点完全放在殡葬祭祀的业务逻辑与用户体验上。