姓名详批 API 接口文档

接口描述

提供完整的姓名详批服务，根据姓氏、名字、出生年月日时及性别，综合姓名学与八字命理进行深度分析，包含综合评分、三才五格、八字排盘、五行调候、优缺点、事业分析、性格分析、流年运势等全方位解读。（注意：接入前请查看详情中的免责声明）

功能特性

• 提供完整的姓名详批服务，根据姓氏、名字、出生年月日时及性别，综合姓名学与八字命理进行深度分析，包含综合评分、三才五格、八…
• 返回 JSON 结构化数据，便于程序解析
• 支持 GET / POST 两种调用方式
• 平台统一密钥鉴权与调用统计，支持积分计费

接口地址

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

请求方式

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

鉴权方式

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

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

请求参数

请求参数 (JSON格式)

[
  {"name": "xs", "type": "string", "required": true, "description": "姓氏"},
  {"name": "mz", "type": "string", "required": true, "description": "名字"},
  {"name": "birthday", "type": "string", "required": true, "description": "出生日期（格式：YYYY-MM-DD）"},
  {"name": "hour", "type": "integer", "required": true, "description": "出生小时（0-23），自动换算为时辰"},
  {"name": "sex", "type": "integer", "required": true, "description": "性别（1=男，0=女）"}
]

响应格式

JSON 格式响应

成功返回示例：

{"code":1,"msg":"查询成功","data":{"name":{"xs":"张","mz":"华","full":"张华"},"birthday":{"year":"1990","month":11,"day":21,"hour":10},"sex":"女","lunar":"一九九零年十月初五10:00-10:59 巳时","score":100,"sancai":"## 您的名字：张华三才配置：木土土（三才配置吉凶为命理总体，不代表本年！）\n\n**木土土的三才配置数理吉凶详解：吉**\n虽易产生不平、不满之念，招致家庭不和，但幸因知机，而养成（仁德雅量）而能亨通安详，总之大体平顺幸福，而必有相当之成就，只因成功运受到压制，故成功之后，恐难再伸展。\n成功运被压抑,不能有所伸张，生不平不满之念，招致家庭不和或不幸，有呼吸器官、眼睛疾患。\n**木土土的三才配置数理总论：下吉**\n1、总论：发展性很小，切勿好高骛远，以免为钱财起纠纷，家庭生活能无忧就该满足，不要不平不满，注重精神生活才是聪明人。\n2、性格：表面乐观，内心苦闷，常有不平不满之心理，待人诚实而自劳，喜批评人家是非，自己却容易被煽动。\n3、意志：意志尚称坚定，但缺乏果断力，处事容易冲动，情绪苦闷又不安定。\n4、事业：一生辛勤而收获不多，常在忧愁中度日，六亲又难相助。\n5、家庭：与父母意见不和，夫妻表面平顺，但时常争吵，家内不太平安。\n6、婚姻：男娶勤俭之妻，夫妻常为小事闹意见；女嫁好胜好强之夫，婚姻不太美满。\n7、子女：子女运佳，责任心重，能在社会上成功。\n8、社交：待人诚恳有雅量，但要领不佳，常有受累之事发生，少管闲事为妙。\n9、精神：为朋友之事及金钱问题操心，心性欠开朗。\n10、财运：与金钱缘薄，纵有积蓄也有限。\n11、健康：易患胃肠病，筋骨酸痛。神经质。\n12、老运：运限平稳，但财源不佳，应注重精神修养。\n**木土土的三才配置性格吉凶：**\n性格稍有迟钝，稳重，易亲近也易离开，成功虽然较迟，但总体上是幸福的。\n基础运：吉\n虽有不平不满之状，但以本来的德量，可无大碍，易患肠胃和腹部之症。\n成功运：下吉\n性情温和周到，善于社交，缺乏牺牲精神。如精心打下良好基础，大发展，大成功。如听之任之，则失去一半的机会。\n人际关系：吉\n心多洗练，容易亲近。温和沉着，有雅量，对人有同情心，荣誉心强。属于能享受家庭的命运。其内心有刚义之肠，却不显现于外表。其易亲近的反面又有易疏冷的缺点,其嫉妒心稍强。","wuxing":{"j":3,"m":1,"s":1,"h":3,"t":0,"b":"金木","k":"水火土","w":"","q":"土","o":null},"bazi":{"nayin":[{"jiazi":"庚午","layin":"路旁土","whsx":{"sx":"马","sx_py":"ma","wh_py":"tu","wx_py":"金火"}},{"jiazi":"丁亥","layin":"屋上土","whsx":{"sx":"猪","sx_py":"zhu","wh_py":"tu","wx_py":"火水"}},{"jiazi":"庚寅","layin":"松柏木","whsx":{"sx":"虎","sx_py":"hu","wh_py":"mu","wx_py":"金木"}},{"jiazi":"辛巳","layin":"白腊金","whsx":{"sx":"蛇","sx_py":"she","wh_py":"jin","wx_py":"金火"}}],"tywh":{"wh":"金","tnwh":"金土","ynwh":"火木水","skzhyj":"金旺得火，方成器皿。\r金能生水，水多金沉；强金得水，方挫其锋。\r金能克木，木多金缺；木弱逢金，必为砍折。\r金赖土生，土多金埋；土能生金，金多土变。","whzx":"金主义，其性刚，其情烈，其味辣，其色白。金盛之人骨肉相称，面方白净，眉高眼深，体健神清。为人刚毅果断，疏财仗义，深知廉耻。太过则有勇无谋，贪欲不仁。不及则身材瘦小，为人刻薄内毒，喜淫好杀，吝啬贪婪。","szwh":"肺与大肠互为脏腑表里，又属气管及整个呼吸系统。过旺或过衰，较宜患大肠，肺，脐，咳痰，肝，皮肤，痔疮，鼻气管等方面的疾病。","hyhw":"宜金者，喜西方。可从事精纤材或金属工具材料，坚硬，决断，武术，鉴定，总管，汽车，交通，金融，工程，种子，开矿，民意代表，伐木，机械等方面的经营和工作。"},"table":{"time":["1990年","11月","21日","巳时"],"ganzhi":["庚午","丁亥","庚寅","辛巳"],"main_stars":["比肩","正官","日主","劫财"],"tian_gan":["庚","丁","庚","辛"],"di_zhi":["午","亥","寅","巳"],"wx_full":["金火","火水","金木","金火"],"cang_gan":["丁 己","壬 甲","甲 丙 戊","丙 庚 戊"],"sub_stars":["正官\/正印","食神\/偏财","偏财\/七杀\/偏印","七杀\/比肩\/偏印"],"di_shi":["沐浴","胎","绝","死"],"kong_wang":["午、未","午、未","午、未","午、未"],"shen_sha":["","文昌贵人","","学堂"],"na_yin":["路旁土","屋上土","松柏木","白腊金"]},"wx_score":{"木":9,"火":26,"土":4,"金":32,"水":7},"wx_count":{"木":1,"火":3,"土":0,"金":3,"水":1},"wx_wangshuai":{"木":"偏弱","火":"偏旺","土":"偏弱","金":"偏旺","水":"偏弱"},"wx_percent":{"木":11.5,"火":33.3,"土":5.1,"金":41,"水":9},"day_gan":"庚","day_wx":"金","bazi_str":"庚午 丁亥 庚寅 辛巳"},"youquedian":"**优点：**\n\n1、美丽性感：你这个优点和别的女生的有点有些不一样，貌似别的女生的有点都是性格上的，但是这个你的优点多发自于是外表的美丽性感和内心的美丽性感。\n\n2、计划周详：你做任何事情前，总会先做一个详细的计划书，你从来都不想面对失败，所以只能做好准备工作，当然这也和他深谋远虑的性格有关，你做事不会只看眼前，还会思考未来怎么样，如何让自己做的事更加有利益，这才是你在思考的。\n\n3、浓烈的爱：你没有平淡的爱，若不是全部，就是没有。而你对对方的要求也是如此。赶快想清楚，这是一场惊心动魄的爱情，错过它，可就机会难求。\n\n4、忠于爱情：你是个谜样的女子。安静、具挑逗力，对异性有不可测的魔力。表面上无法捉摸的你，内心里有强烈而复杂的情绪，一旦认定某人，你就会狂热地效忠与奉献。谈到爱情，你的态度常是不成功便成仁，既壮烈又没有退路。\n\n5、热爱家庭：你虽然很重视自己的事业，但也很在乎你们的家庭，如果实在别无选择，你会舍弃事业而好好打理家庭事务。你独立性很强，总是能够带领一个家庭活的很精彩，把一切家务事做得井井有序。\n\n**缺点：**\n\n1、沉默寡言：你平常总是喜欢一个人待着，你不善表达，也不喜欢与人有太多的交集，可以说你的生活就是两点一线，你没有太大的变化，也不需要变化，你就是喜欢一成不变的人。\n\n2、极端：宁为玉碎，不为瓦全，有时候你总是被这样极端的想法占据自己的全部思维。你很容易受人影响，而且不把心里的想法说出来，憋在心里，对他人充满质疑和不信任，容易钻牛角尖，导致性格有些偏执，想法容易趋向偏激。\n\n3、多疑：你因为敏感，多愁善感的个性而导致外表虽然波澜不惊，内心却是风起云涌，实际上内心是十分脆弱的。你十分多疑，不轻易相信别人，也不容易让人走进内心，不轻易与人交心。\n\n4、占有欲、支配欲强：你安稳的个性能给人安全感，同时也伴随着控制欲和占有欲，把握不好的话就容易给身边的人很大的精神压力，让人觉得和你相处很累。\n\n5、听不得一丁点的谎言：你的生活中是不允许有谎言存在，就算是善良的都不行。比如说男票准备要求婚了，骗你出去玩一下，一会儿给你惊喜，本来在男友的幻想下女票应该是被感动得不知所措，可是现实却是你狠狠的瞪着：你居然欺骗我！男票表示：咱们的剧本里边没有这一段啊亲！无法忍受好吗？","yearyunshi":"本年度对于你而言，整体氛围偏向深邃与转化，内在的力量似乎正在经历某种程度的重塑。年初阶段可能会感受到一些隐藏在表面之下的波动，多一些独处与内省或许有助于看清事情的本质。从大环境来看，本年度似乎为你提供了更多挖掘真相、突破瓶颈的空间，尤其在需要洞察力和韧性的情境中，不轻易放弃的作风可能会逐渐显现出独特的价值。上半年或许更适合清理旧有的积累、放下不再适用的模式，而下半年则可能迎来一些令人耳目一新的转变契机。当然，每个人的转化节奏和深度各不相同，这些描述仅作为一种隐约的参考。\n在个人探索层面，本年度你可能会对\"掌控\"与\"放手\"之间的张力有新的体会，无论是外在的资源还是内在的情绪，找到既能深入又不执着的姿态，或许会成为贯穿全年的修炼。生活中可能会遇到一些触及核心的挑战，保持冷静的观察力和适度的信任会比较有利。同时，本年度也可能出现一些与深度研究、隐秘事务或资源整合相关的机会，如何在保护自身边界的同时拓展影响力，值得多花些心思权衡。需要注意的是，过度沉浸于某种执念或怀疑有时可能会让视野变得狭窄，适当允许脆弱、接受不可控的部分，或许能带来意想不到的释然与力量。\n感情与人际方面，本年度亲密关系的浓度有望得到提升，与重要的人相处时，深度的联结与真诚的袒露往往比表面的热闹更有分量。单身者在社交中或许更容易被神秘、有层次感的气质所吸引，但建立真正的信任大概率需要经历时间的考验。已有亲密关系的人，本年度可能需要更多面对关系中的阴影面，多一些勇气去触碰那些平时回避的话题，反而可能让感情更加真实而牢固。人际交往中，本年度似乎容易在关键时刻获得他人的信赖与托付，不过偶尔也需要分辨哪些秘密值得守护、哪些负担可以卸下。健康方面，关注生殖系统与排泄系统的调养，保持情绪的适度宣泄与深度放松，对于维持身心平衡会有一定的助益。总的来说，本年度是一个适合蜕变与重生的年份，在黑暗中沉淀、在破茧后舒展，或许能在经历之后遇见一个更加完整而通透的自己。","xm_arr":{"xing1":"张","xing1py":"zhang","xing1gb":"張","xing2":null,"xing2py":null,"xing2gb":null,"ming1":"华","ming1py":"hua","ming1gb":"華","ming2":null,"ming2py":null,"ming2gb":null},"bh_wh_arr":{"bihua1":"11","bihua2":null,"bihua3":"14","bihua4":null,"hzwh1":"火","hzwh2":null,"hzwh3":"水","hzwh4":null},"tdr_ge":{"renge":25,"tiange":12,"dige":15,"tian_sancai":"木","ren_sancai":"土","di_sancai":"土","waige":2,"waige_sancai":"木","zhongge":25,"zongge_sancai":"土"}},"time":1788395625}

失败返回示例：

{"code":0,"msg":"请提供姓名参数(xs姓, mz名)","data":null,"time":1788395657}

返回参数说明

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=namexiangpi?key=SK-你的密钥&xs=%E5%BC%A0&mz=%E4%BC%9F&birthday=1993-05-20&hour=10&sex=1"

错误响应

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

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

注意事项

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

开发时间

2026-09-24