| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
35 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_488b58719e2387dec2cd9836dd5d8887 |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET,POST |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
name |
string | 是 | 姓名 | |
birthday |
string | 是 | 出生日期,格式为 YYYY-MM-DD | |
hour |
string | 是 | 出生时辰,为0-23的整数 | |
sex |
string | 是 | 性别,1 代表男性,0 代表女性 | |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
code |
string | 业务状态码,1 表示查询成功 | |
msg |
string | 返回信息,如"查询成功" | |
time |
string | 响应时间戳(Unix时间戳) | |
data |
string | 核心测算数据对象 | |
其他参数见接口详情 |
string | 其他参数见接口详情 | |
{"code":1,"msg":"查询成功","data":{"name":"张三","xs":"张","mz":"三","birthday":{"year":"2006","month":"07","day":"07","hour":"11"},"sex":"男","lunar":"二零零六年六月十二11:00-11:59 午时","score":42,"sancai":"## 您的名字:张三,总之家庭不幸者居多。如人格部为24数,则多温顺有智谋,易发财,可得权利名誉等幸运。","wuxing":{"j":1,"m":1,"s":0,"h":4,"t":2,"b":"火金","k":"木水土","w":"火","q":"水","o":null},"bazi":{"nayin":[{"id":"23","jiazi":"丙戌","layin":"屋上土","whsx":{"sx":"自眠之狗","wh":"屋上土","sx_py":"gou","wh_py":"tu","wx_py":"火土"}},{"id":"32","jiazi":"乙未","layin":"沙中金","whsx":{"sx":"敬重之羊","wh":"沙中金","sx_py":"yang","wh_py":"jin","wx_py":"木土"}},{"id":"34","jiazi":"丁酉","layin":"山下火","whsx":{"sx":"独立之鸡","wh":"山下火","sx_py":"ji","wh_py":"huo","wx_py":"火金"}},{"id":"43","jiazi":"丙午","layin":"天河水","whsx":{"sx":"行路之马","wh":"天河水","sx_py":"ma","wh_py":"shui","wx_py":"火火"}}],"tywh":{"wh":"火","tnwh":"火木","ynwh":"水金土","skzhyj":"火旺得水,方成相济。\r火能生土,土多火晦;强火得土,方止其焰。\r火能克金,金多火熄;金弱遇火,必见销熔。\r火赖木生,木多火炽;木能生火,火多木焚。","whzx":"火主礼,其性急,其情恭,其味苦,其色赤。火盛之人头小脚长,上尖下阔,浓眉小耳,精神闪烁,为人谦和恭敬,纯朴急躁。火衰之人则黄瘦尖楞,语言妄诞,诡诈妒毒,做事有始无终。","szwh":"心脏与小肠互为脏腑表里,又属血脉及整个循环系统。过旺或过衰,较宜患小肠,心脏,肩,血液,经血,脸部,牙齿,腹部,舌部等方面的疾病。","hyhw":"宜火者,喜南方。可从事放光,照明,光学,高热,易燃,油类,酒精类,热饮食,食品,理发,化妆品,人身装饰品,文艺,文学,文具,文化学生,文人,作家,写作,撰文,教员,校长,秘书,出版,公务,正界等方面的经营和事业。"}},"youquedian":"","syfx":"丁字有“烛灯”的暗示,所以2022年您的还是口风严谨些,与朋友聊天注意一些。","xm_arr":{"xing1":"张","xing1py":"zhang","xing1gb":"張","xing2":null,"xing2py":null,"xing2gb":null,"ming1":"三","ming1py":"san","ming1gb":"三","ming2":null,"ming2py":null,"ming2gb":null},"bh_wh_arr":{"bihua1":"11","bihua2":null,"bihua3":"3","bihua4":null,"hzwh1":"火","hzwh2":null,"hzwh3":"金","hzwh4":null},"tdr_ge":{"renge":14,"tiange":12,"dige":4,"tian_sancai":"木","ren_sancai":"火","di_sancai":"火","waige":2,"waige_sancai":"木","zhongge":14,"zongge_sancai":"火"},"rssancai":{"title":"木火火","yy":"得顺调成功发展,但有缺乏耐久力的缺点,或依靠性太强,招失败,有陷入失意病弱之兆。","jx":"平","content":"1、总论:虽有成功运,但不甘寂寞,忍耐力不够,容易一意孤行,陷入孤军奋斗,如能修身养性,定能成功顺调。名利双利,若天运五行属水,青年时代事业难成又逢灾,老运亦欠佳。\n2、性格:外表乐观而豪爽,交际应酬有一套,人缘又好,但个性喜怒无常,感情易热易冷,个性急燥,容易意气用事。\n3、意志:意志尚称坚定,可依自己的理想和努力,达到成功成名,但不耐寂寞独处生活。\n4、事业:做事冲动而积极,很容易功成名就,一展自己的抱负。\n5、家庭:夫妻美满,子女孝顺,但应节制应酬才能保持长久。\n6、姓名测试爱情:男娶热情直率之妻,应减少应酬风流之事;女嫁温厚谦恭之夫,要减少让丈夫多疑之行为。\n7、子女:男孩多于女孩,每个都健康活泼,稍嫌调皮,长大后都能获得相当成就。\n8、社交:人缘很好,朋友很多,易与异性接触,避免桃色事件发生。\n9、精神:外表乐观,内在则脾气暴,常自找精神上的负担。\n10、财运:物质不缺,财源广进,富贵之格。\n11、健康:注意血压过高或心脏病。\n12、老运:可享受晚年,但恐缺天份之乐。","jcy":"可得一时的吉运,但基础薄弱,缺乏耐久力。","jx1":"但天格为1或2时吉利。","cgy":"受上级长辈的照顾关心,能顺利成功发达。","jx2":"吉","rjgx":"有财,男命妻家富足而受福荫,成功顺利,富有社交吸引力,受人扶持,贵人相助而成大气候。","jx3":"吉","xg":"其内具爆发性的品质,表面却极平稳。如火燃湿木一样,虽起初烟而不能成火象,往往有抑制心思,不敢告诉他人的性格,表面矛盾,徒耗精力。擅长手腕,长于舌辩。有虚伪、多曲折者;有病弱、短命、家属子女缘薄者,总之家庭不幸者居多。如人格部为24数,则多温顺有智谋,易发财,可得权利名誉等幸运。"}},"time":1785667869}
{"code":0,"msg":"请提供姓名参数(uname)","data":null,"time":1785667835}
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
| 暂无业务错误码 | |||
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
401 | HTTP 401 | 认证失败 | 请求头中缺少 X-API-Key 或 API Key 无效 |
400 | HTTP 400 | 参数错误 | 缺少必要参数(api_id、endpoint_id、method)或必填业务参数缺失 |
404 | HTTP 404 | 资源不存在 | API不存在、已下架或端点不存在 |
403 | HTTP 403 | 未开通 | 您尚未开通此API,请先开通 |
405 | HTTP 405 | 方法不允许 | 请求方法不在端点允许列表中 |
402 | HTTP 402 | 积分不足 | 账户积分不足以调用该API |
500 | HTTP 500 | 服务器内部错误 | 系统异常 |
接口免责声明
1、本接口仅实现传统国学数理学体系数理运算,输出原始演算数据,供传统文化爱好者技术研究使用;
2、所有演算结果仅供娱乐参考,不代表客观事实,不构成事业、投资、婚恋、择事等任何人生决策建议;
3、下游调用方不得利用接口数据开展封建迷信宣传、有偿测算、有偿择吉等违规业务;
4、因调用方滥用接口、过度依赖测算结果引发的一切损失,逗号API平台不承担任何相关责任。
接口文字说明
1、因传统文化的特殊性,故所有传统书籍中数理值原本为凶的,现都改为下吉,大凶为下下吉,若想保留原始文化的,请自行写程序替换即可。
2、所有结果都是依据国学书籍来进行演算,可能部分书籍原始资料有误,若遇到不对的地方,联系客服指正修改!
接口返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,1表示成功,0表示失败 |
| msg | string | 返回消息,如"查询成功" |
| data | object | 八字精批核心数据对象 |
| time | int | 数据生成时间戳(Unix时间戳) |
| 字段 | 类型 | 说明 |
|---|---|---|
| name | string | 姓名 |
| xs | string | 姓氏 |
| mz | string | 名字 |
| sex | string | 性别(男/女) |
| score | int | 综合评分(0-100) |
| lunar | string | 农历日期(如"二零零六年六月十二") |
| 字段 | 类型 | 说明 |
|---|---|---|
| year | int | 公历年份 |
| month | int | 公历月份 |
| day | int | 公历日期 |
| hour | int | 出生小时(0-23) |
| 字段 | 类型 | 说明 |
|---|---|---|
| xing1 | string | 姓氏(简体) |
| xing1py | string | 姓氏拼音 |
| xing1gb | string | 姓氏繁体 |
| xing2 | string|null | 复姓第二字(单姓为null) |
| ming1 | string | 名字第一字(简体) |
| ming1py | string | 名字第一字拼音 |
| ming1gb | string | 名字第一字繁体 |
| ming2 | string|null | 名字第二字(单名为null) |
| 字段 | 类型 | 说明 |
|---|---|---|
| bihua1 | string | 姓氏笔画数 |
| bihua2 | string|null | 复姓第二字笔画 |
| bihua3 | string | 名字第一字笔画数 |
| bihua4 | string|null | 名字第二字笔画 |
| hzwh1 | string | 姓氏汉字五行(金/木/水/火/土) |
| hzwh2 | string|null | 复姓第二字五行 |
| hzwh3 | string | 名字第一字五行 |
| hzwh4 | string|null | 名字第二字五行 |
| 字段 | 类型 | 说明 |
|---|---|---|
| j | int | 金字个数 |
| m | int | 木字个数 |
| s | int | 水字个数 |
| h | int | 火字个数 |
| t | int | 土字个数 |
| b | string | 补益五行(喜用神) |
| k | string | 克泄五行(忌神) |
| w | string | 旺盛五行 |
| q | string | 缺失五行 |
| o | int | 五行种类数 |
| 字段 | 类型 | 说明 |
|---|---|---|
| tiange | int | 天格数 |
| renge | int | 人格数 |
| dige | int | 地格数 |
| waige | int | 外格数 |
| zhongge | int | 总格数 |
| tian_sancai | string | 天格三才五行 |
| ren_sancai | string | 人格三才五行 |
| di_sancai | string | 地格三才五行 |
| waige_sancai | string | 外格三才五行 |
| zongge_sancai | string | 总格三才五行 |
| 字段 | 类型 | 说明 |
|---|---|---|
| title | string | 三才配置名称(如"金木土") |
| yy | string | 三才要义/总评 |
| jx | string | 三才吉凶(吉/凶/小吉/下吉等) |
| content | string | 三才详细分析(12项分论) |
| jcy | string | 基础运描述 |
| jx1 | string | 基础运吉凶 |
| cgy | string | 成功运描述 |
| jx2 | string | 成功运吉凶 |
| rjgx | string | 人际关系描述 |
| jx3 | string | 人际关系吉凶 |
| xg | string | 性格描述 |
注:data.sancai 字段为该模块的Markdown富文本版本,适合直接渲染展示。
| 字段 | 类型 | 说明 |
|---|---|---|
| bazi_str | string | 八字四柱字符串(如"丙戌 乙未 丁酉 庚子") |
| day_gan | string | 日干(日主天干) |
| day_wx | string | 日主五行(金/木/水/火/土) |
| 字段 | 元素类型 | 说明 |
|---|---|---|
| time | string[] | 四柱时间(年/月/日/时辰) |
| ganzhi | string[] | 四柱干支组合(如["丙戌","乙未","丁酉","庚子"]) |
| main_stars | string[] | 四柱主星/十神(日柱固定为"日主") |
| tian_gan | string[] | 四柱天干 |
| di_zhi | string[] | 四柱地支 |
| wx_full | string[] | 干支完整五行(天干五行+地支五行) |
| cang_gan | string[] | 四柱藏干(空格分隔) |
| sub_stars | string[] | 四柱副星/藏干十神("/"分隔) |
| di_shi | string[] | 四柱地势(十二长生) |
| kong_wang | string[] | 四柱空亡地支 |
| shen_sha | string[] | 四柱神煞 |
| na_yin | string[] | 四柱纳音五行 |
| 字段 | 类型 | 说明 |
|---|---|---|
| wx_score | object | 五行加权分数({"金":19,"木":11,...}) |
| wx_count | object | 五行个数统计 |
| wx_wangshuai | object | 五行旺衰判断(偏旺/中和/偏弱) |
| wx_percent | object | 五行占比(%) |
| 字段 | 类型 | 说明 |
|---|---|---|
| jiazi | string | 干支组合 |
| layin | string | 纳音五行(如"屋上土") |
| whsx.sx | string | 生肖(狗/羊/鸡/虎等) |
| whsx.sx_py | string | 生肖拼音 |
| whsx.wh_py | string | 纳音五行拼音 |
| whsx.wx_py | string | 干支五行拼音 |
| 字段 | 类型 | 说明 |
|---|---|---|
| wh | string | 日主五行 |
| tnwh | string | 同类五行(帮扶日主的五行) |
| ynwh | string | 异类五行(克泄耗日主的五行) |
| skzhyj | string | 五行生克制化宜忌 |
| whzx | string | 五行之性(性格特征) |
| szwh | string | 五行脏腑健康提示 |
| hyhw | string | 宜从事行业与方位 |
| 字段 | 类型 | 说明 |
|---|---|---|
| syfx | string | 事业分析 / 日主特性与职业方向 |
| waigearr | string | 性格分析 / 外在表现(含幸运数字、健康、建议) |
| yearyunshi | string | 流年运势分析(事业/财运/感情/健康/贵人等) |
| youquedian | string | 优缺点分析(可能为空字符串) |
浙公网安备 33059102000262号