八字合婚 API 接口文档

接口描述

提供双方八字合婚分析服务，根据男女双方的公历出生年月日时，推算各自的八字排盘、五行分析，并进行合婚匹配度评估，同时提供结婚吉日参考。（注意：接入前请查看详情中的免责声明）

功能特性

• 提供双方八字合婚分析服务，根据男女双方的公历出生年月日时，推算各自的八字排盘、五行分析，并进行合婚匹配度评估，同时提供结…
• 返回 JSON 结构化数据，便于程序解析
• 支持 GET / POST 两种调用方式
• 平台统一密钥鉴权与调用统计，支持积分计费

接口地址

https://api.souxiaocha.com/apis/gateway?api=bazihunyin

请求方式

GET / POST（业务参数 GET 通过 URL 传递，POST 支持表单或 JSON）

鉴权方式

调用需携带平台密钥（用户中心「令牌管理」获取，SK- 开头）：

• URL 参数：key=SK-你的密钥
• 或请求头：X-API-Key: SK-你的密钥

请求参数

请求参数 (JSON格式)

[
  {"name": "aname", "type": "string", "required": true, "description": "男方姓名（需URL编码）"},
  {"name": "abirthday", "type": "integer", "required": true, "description": "男方生日（公历）"},
  {"name": "ahour", "type": "integer", "required": true, "description": "男方出生小时（0-23）"},
  {"name": "bname", "type": "string", "required": true, "description": "女方姓名（需URL编码）"},
  {"name": "bbirthday", "type": "integer", "required": true, "description": "女方生日（公历）"},
  {"name": "bhour", "type": "integer", "required": true, "description": "女方出生小时（0-23）"}
]

响应格式

JSON 格式响应

成功返回示例：

{"code":1,"msg":"查询成功","data":{"aname":"李华","bname":"李欢","abirthday":{"year":"2006","month":"10","day":"10","hour":10},"bbirthday":{"year":"2006","month":"10","day":"10","hour":10},"a_wuxing":{"j":1,"m":1,"s":1,"h":2,"t":3,"b":"水金","k":"木火土","w":"","q":"","o":1},"b_wuxing":{"j":1,"m":1,"s":1,"h":2,"t":3,"b":"水金","k":"木火土","w":"","q":"","o":1},"a_bazi":{"nayin":[{"jiazi":"丙戌","layin":"屋上土","whsx":{"sx":"狗","sx_py":"gou","wh_py":"tu","wx_py":"火土"}},{"jiazi":"戊戌","layin":"平地木","whsx":{"sx":"狗","sx_py":"gou","wh_py":"mu","wx_py":"土土"}},{"jiazi":"壬申","layin":"剑锋金","whsx":{"sx":"猴","sx_py":"hou","wh_py":"jin","wx_py":"水金"}},{"jiazi":"乙巳","layin":"覆灯火","whsx":{"sx":"蛇","sx_py":"she","wh_py":"huo","wx_py":"木火"}}],"table":{"time":["2006年","10月","10日","巳时"],"ganzhi":["丙戌","戊戌","壬申","乙巳"],"main_stars":["偏财","七杀","日主","伤官"],"tian_gan":["丙","戊","壬","乙"],"di_zhi":["戌","戌","申","巳"],"wx_full":["火土","土土","水金","木火"],"cang_gan":["戊 辛 丁","戊 辛 丁","庚 壬 戊","丙 庚 戊"],"sub_stars":["七杀\/正印\/正财","七杀\/正印\/正财","偏印\/比肩\/七杀","偏财\/偏印\/七杀"],"di_shi":["墓","墓","长生","沐浴"],"kong_wang":["戌、亥","戌、亥","戌、亥","戌、亥"],"shen_sha":["华盖 天德贵人 月德贵人","华盖","学堂 驿马","天乙贵人"],"na_yin":["屋上土","平地木","剑锋金","覆灯火"]},"wx_score":{"木":10,"火":19,"土":26,"金":13,"水":12},"wx_count":{"木":1,"火":2,"土":3,"金":1,"水":1},"wx_wangshuai":{"木":"中和","火":"中和","土":"偏旺","金":"中和","水":"中和"},"wx_percent":{"木":12.5,"火":23.8,"土":32.5,"金":16.3,"水":15},"day_gan":"壬","day_wx":"水","bazi_str":"丙戌 戊戌 壬申 乙巳"},"b_bazi":{"nayin":[{"jiazi":"丙戌","layin":"屋上土","whsx":{"sx":"狗","sx_py":"gou","wh_py":"tu","wx_py":"火土"}},{"jiazi":"戊戌","layin":"平地木","whsx":{"sx":"狗","sx_py":"gou","wh_py":"mu","wx_py":"土土"}},{"jiazi":"壬申","layin":"剑锋金","whsx":{"sx":"猴","sx_py":"hou","wh_py":"jin","wx_py":"水金"}},{"jiazi":"乙巳","layin":"覆灯火","whsx":{"sx":"蛇","sx_py":"she","wh_py":"huo","wx_py":"木火"}}],"table":{"time":["2006年","10月","10日","巳时"],"ganzhi":["丙戌","戊戌","壬申","乙巳"],"main_stars":["偏财","七杀","日主","伤官"],"tian_gan":["丙","戊","壬","乙"],"di_zhi":["戌","戌","申","巳"],"wx_full":["火土","土土","水金","木火"],"cang_gan":["戊 辛 丁","戊 辛 丁","庚 壬 戊","丙 庚 戊"],"sub_stars":["七杀\/正印\/正财","七杀\/正印\/正财","偏印\/比肩\/七杀","偏财\/偏印\/七杀"],"di_shi":["墓","墓","长生","沐浴"],"kong_wang":["戌、亥","戌、亥","戌、亥","戌、亥"],"shen_sha":["华盖 天德贵人 月德贵人","华盖","学堂 驿马","天乙贵人"],"na_yin":["屋上土","平地木","剑锋金","覆灯火"]},"wx_score":{"木":10,"火":19,"土":26,"金":13,"水":12},"wx_count":{"木":1,"火":2,"土":3,"金":1,"水":1},"wx_wangshuai":{"木":"中和","火":"中和","土":"偏旺","金":"中和","水":"中和"},"wx_percent":{"木":12.5,"火":23.8,"土":32.5,"金":16.3,"水":15},"day_gan":"壬","day_wx":"水","bazi_str":"丙戌 戊戌 壬申 乙巳"},"shengxiao":{"a":"狗","b":"狗","hehun_key":"男狗女狗"},"hehun":{"info":"## 合婚解析\n\n恭喜恭喜！根据八字命盘所示，你们的婚配度比较高，两人相处很有默契，但是缺乏一点生活乐趣和激情。所以婚后可以多去一些有趣地方，做一些有趣的事情。\n\n你们因为同属相，性格中会有很多共同的特点。你们有着共同的理念和生活态度，性格温顺，待人友善有礼。在感情方面都比较保守，追求稳定和谐的感情和家庭生活，都是保守稳重的人。你们都对感情忠诚，容不得半点虚假。你们通常初识就会因为相同的个性，相同的思想观念，共同话题和共同的兴趣而有一见倾心，一见如故之感。你们彼此坦诚相待，双方都具有乐观坚韧的性格，通情达理，顾全大局，彼此尊重，是倾心相与，幸福美满的一对。\n\n男生有着强烈的家庭责任感，每当家庭遇到困境，他都能挺身而出并能载誉而归。女生快人快语又不失温柔，倘若你们能够在各自的性格中取长补短，在相处中扬长避短，在共同做出决定之前经过周密的考虑，那么你们的关系会产生牢不可破的默契，双方都要建立起信心，相互信任，才能相处更愉快。\n## 男生解析\n\n男生平时性格直爽、踏实、爱打抱不平，能给身边的人带来安全感。且平时他们善于与人相处，虽然平时很难相信人，但是一旦接受就会坦诚相待。不过有时属狗男做事过于传统，让人感觉枯燥。\n男人在平时的生活中非常踏实，少有坏习惯，善于倾听身边人的烦恼，分担他人的不快，拥有不错的人缘。在家庭生活中，男生有很重的家庭观念，是家庭中的顶梁柱，会给妻子和孩子很多的爱，也会保护每一个家庭成员。在事业上，男生做事努力、踏实、拥有不错的管理才能，且对公司忠心，是不错的工作伙伴。在感情上，男生对爱情专一，结婚后会对自己的妻子很好。\n## 女生解析\n\n女生性格正直、直率、充满正义感，平时为人仗义、处事公平，愿意倾听他人的烦恼，分担他人的不快，是不可多得的新世纪好女人。在生活中，女生拥有较高的警觉性和坚定的心性，一旦决定做什么事情，不管多么的困难都不会半途而废，会坚持到底。在身边的朋友遇到困难时也会挺身而出帮助度过难关。且平时有不错的艺术品位，热爱大自然。在家庭生活中，女生也是不错的妻子，会照顾好家人的日常生活，在家人遇到烦恼时，会成为对方最好的倾听者。在事业上，女生坚信成功不会从天而降，自己想要的东西只有经过自己的一步步努力才能获得。因此有自己的事业目标，并且会按部就班的朝着自己的目标不断努力，平时比较适合比较考验耐心的工作。在感情上，女生对爱情比较专一，拥有爱情洁癖，面对喜欢的人会直接说出来。\n## 夫妻相处之道\n\n夫妻相处之道首先要做到坦诚相待，切勿遮遮掩掩这是经营婚姻之大忌讳。坦诚相待是夫妻在婚姻生活中建立相互信任的基础条件之一。比如，夫妻双方各一方出门有事情来说，可能爱人都会问准备出去做什么事情呢？或谈什么生意呢？若这时回复的含含糊糊，不清不楚，爱人心里就可能要产生许多疑问和怀疑了。所以当我们准备出去做什么就说什么，这样不仅可以让爱人放心，免得担心，夫妻生活中最好坦诚相待，更能化解爱人心中的疑问。切勿说一套做一套，俗话说：“常在河边走，哪有不湿鞋”，一旦被爱人无意地拆穿了谎言，那么夫妻之间的信任也就被打破了，从此夫妻之间的生活将步入怀疑对方的局面了。\n## 合婚总结\n\n相爱是一门艺术，爱是两个人一起成长，这就必须得有交流，有交流才有了解，有了解才有更深的爱。交流必然会有争执的可能，但这不是坏事，暴露矛盾相比掩盖矛盾来说最终更有利于婚姻和谐，沉默不是解决问题，而只是隐瞒和回避问题。根据你们的八字合婚解析，婚后相处注意事项总结如下：\n\n1、相互沟通，有问题及时表达，当你内心有了抱怨，一定要主动跟对方诉说，而不是寄托给所谓的蓝颜红颜。\n\n2、相互包容，接纳彼此非原则性的不完美，可以改变自己，而不要试图改变对方。\n\n3、远离暧昧，不要跟非亲属的异性有非工作原因的一对一约会。\n\n4、表达感激，每当我们有机会的时候，就告诉我们的伴侣我们的感激。哪怕只是很普通的小事情。\n\n5、保持关注与体贴，即使是一些体贴的小举动，都可以对关系有着积极的影响。","pfen":"0"},"jiehunjiri":{"info":"## 附2022年结婚吉日\n\n2022年一月结婚吉日\n\n2022年1月3日农历2021年腊月初一星期一\n\n2022年1月9日农历2021年腊月初七星期日\n\n2022年1月13日农历2021年腊月十一星期四\n\n2022年1月14日农历2021年腊月十二星期五\n\n2022年1月15日农历2021年腊月十三星期六\n\n2022年1月16日农历2021年腊月十四星期日\n\n2022年1月21日农历2021年腊月十九星期五\n\n2022年1月25日农历2021年腊月廿三星期二\n\n2022年1月26日农历2021年腊月廿四星期三\n\n2022年1月27日农历2021年腊月廿五星期四\n\n2022年1月28日农历2021年腊月廿六星期五\n\n2022年二月结婚吉日\n\n2022年2月2日农历2022年正月初二星期三\n\n2022年2月4日农历2022年正月初四星期五\n\n2022年2月7日农历2022年正月初七星期一\n\n2022年2月8日农历2022年正月初八星期二\n\n2022年2月10日农历2022年正月初十星期四\n\n2022年2月11日农历2022年正月十一星期五\n\n2022年2月14日农历2022年正月十四星期一\n\n2022年2月16日农历2022年正月十六星期三\n\n2022年2月19日农历2022年正月十九星期六\n\n2022年2月22日农历2022年正月廿二星期二\n\n2022年2月26日农历2022年正月廿六星期六\n\n2022年2月28日农历2022年正月廿八星期一\n\n2022年三月结婚吉日\n\n2022年3月3日农历2022年二月初一星期四\n\n2022年3月4日农历2022年二月初二星期五\n\n2022年3月7日农历2022年二月初五星期一\n\n2022年3月12日农历2022年二月初十星期六\n\n2022年3月13日农历2022年二月十一星期日\n\n2022年3月19日农历2022年二月十七星期六\n\n2022年3月24日农历2022年二月廿二星期四\n\n2022年3月25日农历2022年二月廿三星期五\n\n2022年3月31日农历2022年二月廿九星期四\n\n2022年四月结婚吉日\n\n2022年4月5日农历2022年三月初五星期二\n\n2022年4月14日农历2022年三月十四星期四\n\n2022年4月17日农历2022年三月十七星期日\n\n2022年4月19日农历2022年三月十九星期二\n\n2022年4月23日农历2022年三月廿三星期六\n\n2022年4月29日农历2022年三月廿九星期五\n\n2022年五月结婚吉日\n\n2022年5月1日农历2022年四月初一星期日\n\n2022年5月4日农历2022年四月初四星期三\n\n2022年5月12日农历2022年四月十二星期四\n\n2022年5月13日农历2022年四月十三星期五\n\n2022年5月14日农历2022年四月十四星期六\n\n2022年5月21日农历2022年四月廿一星期六\n\n2022年5月24日农历2022年四月廿四星期二\n\n2022年5月26日农历2022年四月廿六星期四\n\n2022年5月28日农历2022年四月廿八星期六\n\n2022年六月结婚吉日\n\n2022年6月2日农历2022年五月初四星期四\n\n2022年6月5日农历2022年五月初七星期日\n\n2022年6月6日农历2022年五月初八星期一\n\n2022年6月7日农历2022年五月初九星期二\n\n2022年6月8日农历2022年五月初十星期三\n\n2022年6月11日农历2022年五月十三星期六\n\n2022年6月14日农历2022年五月十六星期二\n\n2022年6月17日农历2022年五月十九星期五\n\n2022年6月18日农历2022年五月二十星期六\n\n2022年6月19日农历2022年五月廿一星期日\n\n2022年6月23日农历2022年五月廿五星期四\n\n2022年6月26日农历2022年五月廿八星期日\n\n2022年七月结婚吉日\n\n2022年7月1日农历2022年六月初三星期五\n\n2022年7月2日农历2022年六月初四星期六\n\n2022年7月8日农历2022年六月初十星期五\n\n2022年7月9日农历2022年六月十一星期六\n\n2022年7月12日农历2022年六月十四星期二\n\n2022年7月13日农历2022年六月十五星期三\n\n2022年7月17日农历2022年六月十九星期日\n\n2022年7月20日农历2022年六月廿二星期三\n\n2022年7月21日农历2022年六月廿三星期四\n\n2022年7月24日农历2022年六月廿六星期日\n\n2022年7月25日农历2022年六月廿七星期一\n\n2022年7月29日农历2022年七月初一星期五\n\n2022年八月结婚吉日\n\n2022年8月2日农历2022年七月初五星期二\n\n2022年8月5日农历2022年七月初八星期五\n\n2022年8月6日农历2022年七月初九星期六\n\n2022年8月7日农历2022年七月初十星期日\n\n2022年8月8日农历2022年七月十一星期一\n\n2022年8月9日农历2022年七月十二星期二\n\n2022年8月13日农历2022年七月十六星期六\n\n2022年8月15日农历2022年七月十八星期一\n\n2022年8月19日农历2022年七月廿二星期五\n\n2022年8月20日农历2022年七月廿三星期六\n\n2022年8月27日农历2022年八月初一星期六\n\n2022年8月31日农历2022年八月初五星期三\n\n2022年九月结婚吉日\n\n2022年9月1日农历2022年八月初六星期四\n\n2022年9月2日农历2022年八月初七星期五\n\n2022年9月6日农历2022年八月十一星期二\n\n2022年9月9日农历2022年八月十四星期五\n\n2022年9月13日农历2022年八月十八星期二\n\n2022年9月14日农历2022年八月十九星期三\n\n2022年9月15日农历2022年八月二十星期四\n\n2022年9月21日农历2022年八月廿六星期三\n\n2022年9月25日农历2022年八月三十星期日\n\n2022年9月26日农历2022年九月初一星期一\n\n2022年9月27日农历2022年九月初二星期二\n\n2022年9月30日农历2022年九月初五星期五\n\n2022年十月结婚吉日\n\n2022年10月3日农历2022年九月初八星期一\n\n2022年10月7日农历2022年九月十二星期五\n\n2022年10月8日农历2022年九月十三星期六\n\n2022年10月17日农历2022年九月廿二星期一\n\n2022年10月20日农历2022年九月廿五星期四\n\n2022年10月28日农历2022年十月初四星期五\n\n2022年10月29日农历2022年十月初五星期六\n\n2022年十一月结婚吉日\n\n2022年11月1日农历2022年十月初八星期二\n\n2022年11月9日农历2022年十月十六星期三\n\n2022年11月10日农历2022年十月十七星期四\n\n2022年11月11日农历2022年十月十八星期五\n\n2022年11月13日农历2022年十月二十星期日\n\n2022年11月14日农历2022年十月廿一星期一\n\n2022年11月21日农历2022年十月廿八星期一\n\n2022年11月22日农历2022年十月廿九星期二\n\n2022年11月23日农历2022年十月三十星期三\n\n2022年11月25日农历2022年十一月初二星期五\n\n2022年11月26日农历2022年十一月初三星期六\n\n2022年十二月结婚吉日\n\n2022年12月3日农历2022年十一月初十星期六\n\n2022年12月4日农历2022年十一月十一星期日\n\n2022年12月5日农历2022年十一月十二星期一\n\n2022年12月10日农历2022年十一月十七星期六\n\n2022年12月14日农历2022年十一月廿一星期三\n\n2022年12月15日农历2022年十一月廿二星期四\n\n2022年12月17日农历2022年十一月廿四星期六\n\n2022年12月22日农历2022年十一月廿九星期四\n\n2022年12月26日农历2022年腊月初四星期一\n\n2022年12月29日农历2022年腊月初七星期四"}},"time":1785742304}

失败返回示例：

{"code":0,"msg":"请提供双方姓名参数(aname, bname)","data":null,"time":1785742151}

返回参数说明

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=bazihunyin?key=SK-你的密钥&aname=%E5%BC%A0%E4%BC%9F&abirthday=1993-05-20&ahour=10&bname=%E6%9D%8E%E5%A8%9C&bbirthday=1995-08-15&bhour=14"

错误响应

平台级错误（errcode）：11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。

失败时请以响应体中的 code / errcode 与 msg 判断。

注意事项

• 本接口为平台代理的聚合数据服务，数据与稳定性以上游服务为准
• 涉及命理、测算类内容（如有）仅供娱乐参考，不构成任何现实建议
• 请合理控制调用频率，避免高频恶意调用触发风控
• 密钥请妥善保管，勿在公开代码或前端页面中暴露

开发时间

2026-09-24