八字-八字测算

文档说明

        八字，即生辰八字，是一个人出生时的干支历日期。年干和年支组成年柱，月干和月支组成月柱，日干和日支组成日柱，时干和时支组成时柱，一共四柱，四个干和四个支共八个字，故又称四柱八字。是命理研究方法之中最正统的一种。并在此基础上，结合古籍测算出骨相，五行，姻缘，财运，基本信息。如果需要十年大运以及流年测算结果，请参阅八字-八字精算接口。

请求方式

POST GET 

https://api.yuanfenju.com/index.php/v1/Bazi/cesuan

请求头

字段 类型 描述
Content-Type String application/x-www-form-urlencoded

请求参数

字段 类型 描述
api_key String 密钥
name String 姓名
sex Int 性别 0男 1女
type Int 历类型 0农历 1公历
year Int 出生年 例: 1988
month Int 出生月 例: 8
如果是闰月，请参考 工具-阴阳历互相转换 获取公历再行带入
day Int 出生日 例: 7
hours Int 出生时 例: 12
minute Int 出生分 例: 30     
如果不知道具体分，可以传数字 0
sect Int 流派 例：1：晚子时日柱算明天 2：晚子时日柱算当天     
非必传，如果不传递这个参数，默认1
zhen Int 是否使用真太阳时 例：
1：使用中国真太阳时(需传省和市)
2：不使用真太阳时
3：使用全球真太阳时(需传经纬度)    
非必传，如果不传递这个参数，默认2
province String 省 例：北京市    
非必传，但若 zhen=1，则省与市皆为必传参数。点击此处了解省市列表
city String 市 例：北京    
非必传，但若 zhen=1，则省与市皆为必传参数。点击此处了解省市列表
longitude float 十进制经度 例：-77.036871    
非必传，但若 zhen=3，则经度与纬度皆为必传参数。
经度范围：-180～180，浮点数，小数点后最多6位。
latitude float 十进制纬度 例：38.907192    
非必传，但若 zhen=3，则经度与纬度皆为必传参数。
纬度范围：-90～90，浮点数，小数点后最多6位。
timezone string 时区（IANA 格式），例：Asia/Shanghai
非必传，默认 Asia/Shanghai
● zhen = 1（中国真太阳时）：时区固定为 Asia/Shanghai（程序会忽略传入值）
● zhen = 2（不使用真太阳时）：本参数不影响计算
● zhen = 3（全球真太阳时）：建议传出生地的 IANA 时区
例：纽约 America/New_York，新加坡 Asia/Singapore
使用当地时区可确保正确处理夏令时（DST）。
点击 此处 查看完整时区列表。
lang String 多语言：zh-cn 、en-us 、zh-tw     
非必传，如果不传递这个参数，默认为 zh-cn
factor String 调整因子：例：0：不作调整 1：需要作调整     
非必传，如果不传递这个参数，默认为 0
返回数据中，姻缘(yinyuan)，财运(caiyun)，命运(mingyun)解析有一定的重复率，
可添加调整因子降低重复概率。

请求参数示例

$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'name' => '张三',
'sex' => '1',
'type' => '1',
'year' => '1988',
'month' => '11',
'day' => '8',
'hours' => '12',
'minute' => '20',
'zhen' => '1',
'province' => '北京市',
'city' => '北京',
];

返回参数

字段 类型 描述
errcode String 请求状态码 0成功 其它为失败
errmsg String 状态码说明
notice String 声明
data Json 数据信息

成功返回示例

{
  "errcode": 0,
  "errmsg": "请求成功",
  "notice":"本次测算结果仅供娱乐使用，请勿用于封建迷信和违法用途。",
  "data": {
    "base_info": { //基本信息
       "zhen": { //考虑真太阳时才会有此字段，不考虑真太阳时就没有这个字段
            "province": "北京市",  //真太阳时省市
            "city": "北京",       //真太阳时省市
            "jingdu": "116.46",  //真太阳经度
            "weidu": "39.92",    //真太阳纬度
            "shicha": "晚0小时14分10秒" //考虑真太阳的时差
            },
      "sex": "坤造",  //性别
      "name": "张三", //姓名
      "gongli": "1988年11月8日12时20分",    //公历年
      "nongli": "戊辰年 九月 廿九日 午时",    //农历年
      "qiyun": "9年6月26天起运",            //起运
      "jiaoyun": "1998年4月16日16时52分1秒" //交运
      "zhengge": "伤官格"                  //八字正格
      "wuxing_xiji": "喜水 用金 闲木 仇火 忌土" //五行喜忌
    },
    "bazi_info": { //八字信息
      "kw": "戌亥", //空亡
      "tg_cg_god": [ //天干十神
        "伤",        //天干十神【年】
        "杀",        //天干十神【月】
        "日元",      //天干十神【日】
        "劫"         //天干十神【时】
      ],
      "bazi": "戊辰 癸亥 丁卯 丙午", //八字干支信息：分别对应 戊辰年 癸亥月 丁卯日 丙午时
      "na_yin": "大林木"           //纳音
    },
    "chenggu": {   //称骨信息
      "year_weight": "1.2", //称骨年重
      "month_weight": "1.8",//称骨月重
      "day_weight": "1.6",  //称骨日重
      "hour_weight": "1.0", //称骨时重
      "total_weight": "5.6",//称骨总重
      "description": "人品非凡，胸怀磊落，早年尝过不少苦楚，但福禄无穷，财源滚滚，晚年丰足。" //称骨批示
    },
    "wuxing": {    //五行信息：五行从先天纳音五行和八字能量五行角度分析，可按需选用，两种分析角度不同，结果也会不同，甚至截然相反。
      "detail_desc": "戊辰年生大林木命", //先天五行纳音
      "simple_desc": "木",            //先天五行属性
      //八字能量五行分析(可以跟喜用神的五行能量对应)
      "simple_description": "从五行能量来看，主能量火气盛，主热忱之质天赋自带。缘主先天具感染力，行动力强，善恶分明，富正义感。火气偏盛易生急躁，需防冲动误事。次五行能量属土，后天运势主厚积薄发之态。缘主后天在奔波中渐显稳重，中年后根基愈固，行事更重长远。需防安逸环境生惰性，宜持精进之心。后天利于在稳进中求成，事业多靠口碑积累，晚年根基深厚，可享基业之福。",
      //先天纳音五行分析
      "detail_description": "先天纳音大林木参天而立，天性正直向上。禀赋进取之心，有远大志向，坚韧不拔，能在逆境中生长，自带威严。待人坦诚，善恶分明，不喜阿谀。易显孤傲，不善合群，略显固执。天赋在于挺拔成长，然需防清高离群。后天经责任淬炼，学会了适度留白与自我关照。热忱包容的本性不变，却懂得设立边界，奉献中添了自我保护，积极主动更兼分寸感。责任感化为稳健支撑，能带动他人亦懂借力分担，昔日操心过甚变为统筹有度。火焰温暖而不耗竭，既能持续释放光热照亮周遭，也懂得留存能量，在付出与自我滋养间找到平衡，热忱而不疲惫。"
    },
    "yinyuan": {  //姻缘信息
      "sanshishu_yinyuan": "另一半必须年长十五年或以上，夫妇有共同的兴趣，互相尊重，晚年二人死亡的差距不足五年。" //姻缘批示
    },
    "caiyun": {   //财运信息
      "sanshishu_caiyun": {
        "simple_desc": "先苦后甜", //三世书财运简批
        "detail_desc": "暗禄，受前世影响，今生与家人难和睦相处，别奢望可以靠屋企发达。财运先苦后甜，需依赖朋友致富，不妨找个有信用的拍档做生意。晚景甚佳，积落不少金钱，长寿而健康。" //三世书财运详批
      }
    },
    "sizhu": {   //四柱信息
      "rizhu": "丁卯日柱之婚姻，为直觉灵敏，喜用成例，而耐容忍，具有学者之气质，而酷酷嗜陈旧古迹，是守旧复古之象态。其气也，震动百里，惊远惧迩之象，阴火焰强，而力韧，纯焚幔蚀，能锻强钢。丁卯日柱之佳配为壬戌，遇合之机在子水岁运，肖鼠之年，以属犬者性合。此类型态之婚姻，属水朏交溶之态，混为一体，礼仁下士，紧随不舍，莲荷出污泥而不染，气质清雅，一语惊天之态，琴韵之声也。" //日柱论命
    },
    "mingyun": {   //命运批示
      "sanshishu_mingyun": "时遇天文秀气清，聪明智慧心性灵，男财女秀身清洁，满腹文章锦绣成。"
    },
    "sx": "龙",     //生肖信息
    "xz": "天蝎座",   //星座信息
    "xiyongshen": { //喜用神   无敌律数八字五行量化法
         "qiangruo": "八字偏弱", //八字强弱
         "xiyongshen": "金，水", //以金，水为喜用神
         "jishen": "水",     //以水为忌神
         "xiyongshen_desc": "身弱，需补助，避免克泄耗，喜用金补水，避木忌土火。", //喜用神说明
         "jin_number": 0,   //五行统计 金有0个
         "mu_number": 1,    //五行统计 木有1个
         "shui_number": 2,  //五行统计 水有2个
         "huo_number": 3,   //五行统计 火有3个
         "tu_number": 2,    //五行统计 土有2个
         "tonglei": "金水", //同类为金水
         "yilei": "木火土",  //异类为木火土
         "rizhu_tiangan": "水" //命主五行属水
         "zidang": 0,      //自党分
         "yidang": 9,      //异党分
         "zidang_percent": "0%", //自党占百分比
         "yidang_percent": "100%",//异党占百分比
         "jin_score": 75,  //五行金能量分数
         "mu_score": 16,   //五行木能量分数
         "shui_score": 118,//五行水能量分数
         "huo_score": 36,//五行火能量分数
         "tu_score": 139,//五行土能量分数
         "jin_score_percent": "19.53%", //五行金能量占比
         "mu_score_percent": "4.17%",   //五行木能量占比
         "shui_score_percent": "30.73%", //五行水能量占比
         "huo_score_percent": "9.38%", //五行火能量占比
         "tu_score_percent": "36.2%", //五行土能量占比
         "yinyang": "阴阳平衡" //五行阴阳参考
       }
   }
}

失败返回示例

{
  "errcode": -1,
  "errmsg": "日期有误",
}
汇总