姓名测试打分系统API接口文档 GET / POST 娱乐测试

姓名测试打分系统，融合五格剖象法、三才配置理论，严格采用《康熙字典》汉字笔画规则自动计算姓名数理。（注意：免责声明见接口详情）

请求 GET / POST返回 application/json2 积分 / 次上线 2026-09-24 14:57:41

姓名测试打分系统，融合五格剖象法、三才配置理论，严格采用《康熙字典》汉字笔画规则自动计算姓名数理。（注意：免责声明见接口详情）

2 积分 / 次调用次数: 3正常运行KEY 必填
接口信息
GET / POST api.souxiaocha.com/apis/gateway?api=namescore
方法
GET / POST
分类
娱乐测试
计费
2 积分 / 次
KEY
KEY 必填
调用
3
QPM
不限制
鉴权
Query 参数、Header(X-API-Key)
作者
—

姓名测试打分系统接口信息

接口地址：
https://api.souxiaocha.com/apis/gateway?api=namescore
请求方式：
GET / POST
返回格式：
application/json

调用统计

3总调用次数
请求示例 · GET
GET https://api.souxiaocha.com/apis/gateway?api=namescore

apikey=你的API密钥&xs=请填写xs&mz=请填写mz

GET 参数放在查询字符串中。参数值请替换为实际有效值。

姓名测试打分系统请求参数

参数名类型必填说明示例
xsstring是姓氏
mzstring是名字
返回示例
{"code":1,"msg":"查询成功","data":{"name":"张华","xs":"张","mz":"华","score":100,"score_desc":"你的名字起得简直完美，有这样的名字，只要自己不去骄奢淫逸，能够勤劳，一生都会一帆风顺的。","ge":{"tian":{"num":12,"wu":"木","info":"优点：1、温柔贤惠:你无论是职业太太还是家庭主妇，你总会优先处理好家庭细务，你不会因为工作就松懈对家庭的打理，所以你对外是一名强势的职业女性，对内则是一位好妻子好母亲，你能够陪爱人一起奋斗，也能够和爱人一起柴米油盐。2、温文尔雅:俗话说腹中有诗气自华，你就是这种温文尔雅的女生。因为对待事情都比较冷静理智，所以你总是能够给人一种优雅温文的感觉，这种感觉是别人无论如何也不能够带来的。3、力争上游:你虽然身处在各种不同的环境，从事着各种不同的行业；你力争上游的意念是不会改变的。那是你个性上最大的特点。 你从来不会自甘堕落，在你的心里，只有前进，从来不轻易认输。4、善良体贴:你有着传统的家庭观念，对于自己的家人，有着相当程度的忠诚。  你是最善良的人，体贴负责为你着想，不抱怨不埋怨，好姑娘。5、淡定自立:你凡事喜欢靠自己，认为没有任何人有义务去帮你，能自己完成的就不要去麻烦别人，即使对于自己有些困难的事也要一拼到底。缺点：1、刻板无趣:你是名副其实的“不苟言笑”者。你有时候可能被称为女汉子，男人婆一类的，这是因为你大多数都是事业型的，很强悍的那种。2、过度犹豫:你平常总是很让人纠结，一点小事都可能会犹豫不决，例如今晚吃什么，你可能就纠结好久，更别提某些大事了，要你下决策的话，绝对能够逼死人，当然这也是你谨慎的体现，只是太优柔寡断了也不太好。3、思想传统而自卑：你有着传统守旧的思想，很多时候会因为思想传统刻板而产生自卑心态。你通常是在一个大家庭或者团体里面扮演一个严肃有原则且公平的领导者，长期的封闭会让你有些自卑。4、无法承受失败：你太努力，太现实，太自信，所以失败会让你失落很久，无法接受失败的痛和事实，比较悲观，从而也导致失去了许多生活的乐趣。5、没有主见：很多时候你都比较没有主见，没有主见就意味着很多事情都要其他人操心，要其他人做决定。这样的生活会特别容易累。大概是你的男友也是这样子，当然如果男友是像一些男人那样霸道喜欢帮女友做决定的还好，但是其他男生就不一定了。所以你要自己学会做主，让自己变得有主见起来。","pfen":0},"ren":{"num":25,"wu":"土","info":"      数理值：25      签语：(英俊)：资性英敏的刚毅数。(大吉)      详解：　　基业：君臣、首领、福星、文昌、企业、财禄、技艺、财库、进田。　　健康：健康自在，三才善良者可望长寿。　　含义：资性英敏，有奇特的才智， 唯性情不平衡而偏重于一方，言语多少有点棱角柔中带硬，或者有怪脾气，是故涵养不足者，多成怪人，与外人打交道缺谦虚。以英俊之才，自有克成大业。倘任意气用事傲慢无礼，恐弄吉成凶。","pfen":25},"di":{"num":15,"wu":"土","info":"      数理值：15      签语：(福寿)：福寿共照的立身家数。(大吉)      详解：　　基业：天官、贵人、福星、官禄、进田、畜产。　　家庭：清静家田，园满之象子孙昌盛。　　健康：海底明珠，安稳徐庆，健康自如。　　含义：此数为最大好运，福寿园满之象，顺和、雅量。多受福泽，德高望重，自成大业，富贵荣华，吉祥有德，繁荣兴家的大吉数。","pfen":25},"wai":{"num":15,"wu":"土","info":"      数理值：15      签语：(福寿)：福寿共照的立身家数。(大吉)      详解：　　基业：天官、贵人、福星、官禄、进田、畜产。　　家庭：清静家田，园满之象子孙昌盛。　　健康：海底明珠，安稳徐庆，健康自如。　　含义：此数为最大好运，福寿园满之象，顺和、雅量。多受福泽，德高望重，自成大业，富贵荣华，吉祥有德，繁荣兴家的大吉数。","pfen":25},"zong":{"num":25,"wu":"土","info":"      数理值：25      签语：(英俊)：资性英敏的刚毅数。(大吉)      详解：　　基业：君臣、首领、福星、文昌、企业、财禄、技艺、财库、进田。　　健康：健康自在，三才善良者可望长寿。　　含义：资性英敏，有奇特的才智， 唯性情不平衡而偏重于一方，言语多少有点棱角柔中带硬，或者有怪脾气，是故涵养不足者，多成怪人，与外人打交道缺谦虚。以英俊之才，自有克成大业。倘任意气用事傲慢无礼，恐弄吉成凶。","pfen":25}},"sancai":{"config":"木土土","info":"木土土的三才配置数理吉凶详解：吉虽易产生不平、不满之念，招致家庭不和，但幸因知机，而养成（仁德雅量）而能亨通安详，总之大体平顺幸福，而必有相当之成就，只因成功运受到压制，故成功之后，恐难再伸展。成功运被压抑,不能有所伸张，生不平不满之念，招致家庭不和或不幸，有呼吸器官、眼睛疾患。木土土的三才配置数理总论：凶1、总论：发展性很小，切勿好高骛远，以免为钱财起纠纷，家庭生活能无忧就该满足，不要不平不满，注重精神生活才是聪明人。2、性格：表面乐观，内心苦闷，常有不平不满之心理，待人诚实而自劳，喜批评人家是非，自己却容易被煽动。3、意志：意志尚称坚定，但缺乏果断力，处事容易冲动，情绪苦闷又不安定。4、事业：一生辛勤而收获不多，常在忧愁中度日，六亲又难相助。5、家庭：与父母意见不和，夫妻表面平顺，但时常争吵，家内不太平安。6、婚姻：男娶勤俭之妻，夫妻常为小事闹意见；女嫁好胜好强之夫，婚姻不太美满。7、子女：子女运佳，责任心重，能在社会上成功。8、社交：待人诚恳有雅量，但要领不佳，常有受累之事发生，少管闲事为妙。9、精神：为朋友之事及金钱问题操心，心性欠开朗。10、财运：与金钱缘薄，纵有积蓄也有限。11、健康：易患胃肠病，筋骨酸痛。神经质。12、老运：运限平稳，但财源不佳，应注重精神修养。木土土的三才配置性格吉凶：性格稍有迟钝，稳重，易亲近也易离开，成功虽然较迟，但总体上是幸福的。基础运：吉虽有不平不满之状，但以本来的德量，可无大碍，易患肠胃和腹部之症。成功运：凶性情温和周到，善于社交，缺乏牺牲精神。如精心打下良好基础，大发展，大成功。如听之任之，则失去一半的机会。人际关系：吉心多洗练，容易亲近。温和沉着，有雅量，对人有同情心，荣誉心强。属于能享受家庭的命运。其内心有刚义之肠，却不显现于外表。其易亲近的反面又有易疏冷的缺点,其嫉妒心稍强。","pfen":12},"char_info":{"xs_a":{"id":"2311","jianti":"张","fanti":"張","sum":"11","stroke":"5153154","unicode":"U+5F20","gb":"D5C5","wux":"火","pin":"","bushou":"","yi":"","pass":"2"},"xs_b":null,"mz_a":{"id":"1120","jianti":"华","fanti":"華","sum":"14","stroke":"323512","unicode":"U+534E","gb":"BBAA","wux":"水","pin":"huá","bushou":"十","yi":"☆[ huá ]\r☆美丽而有光彩的：～丽。～艳。～彩。～贵。～章。～表（亦称“桓表”）。～盖。\r☆精英：精～。含英咀（jǔ）～。\r☆开花：～而不实。春～秋实。\r☆繁盛：繁～。荣～富贵。\r☆奢侈：浮～。奢～。\r☆指中国或汉族：～夏。中～。～裔。～胄（ａ．华夏的后裔；ｂ．贵族的后裔）。～工。\r☆敬辞，用于跟对方有关的事物：～翰（称人书信）。～诞（称人生日）。～居（称人住宅）。\r☆头发花白：～发（fà）。～颠（指年老）。\r☆指时光：年～。韶～。\r☆[ huà ]\r☆〔～山〕山名，在中国陕西省。\r☆姓。\r☆[ huā ]\r☆古同“花”，花朵。","pass":"1"},"mz_b":null}},"time":1785506522}

详细文档

姓名测试打分系统 API 接口文档

接口描述

姓名测试打分系统，融合五格剖象法、三才配置理论，严格采用《康熙字典》汉字笔画规则自动计算姓名数理。（注意：免责声明见接口详情）

功能特性

  • 姓名测试打分系统，融合五格剖象法、三才配置理论，严格采用《康熙字典》汉字笔画规则自动计算姓名数理。（注意：免责声明见接口…
  • 返回 JSON 结构化数据，便于程序解析
  • 支持 GET / POST 两种调用方式
  • 平台统一密钥鉴权与调用统计，支持积分计费

接口地址

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

请求方式

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

鉴权方式

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

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

请求参数

参数名 类型 必填 描述
xs string 是 姓氏
mz string 是 名字

请求参数 (JSON格式)

[
  {"name": "xs", "type": "string", "required": true, "description": "姓氏"},
  {"name": "mz", "type": "string", "required": true, "description": "名字"}
]

响应格式

JSON 格式响应

成功返回示例：

{"code":1,"msg":"查询成功","data":{"name":"张华","xs":"张","mz":"华","score":100,"score_desc":"你的名字起得简直完美，有这样的名字，只要自己不去骄奢淫逸，能够勤劳，一生都会一帆风顺的。","ge":{"tian":{"num":12,"wu":"木","info":"优点：1、温柔贤惠:你无论是职业太太还是家庭主妇，你总会优先处理好家庭细务，你不会因为工作就松懈对家庭的打理，所以你对外是一名强势的职业女性，对内则是一位好妻子好母亲，你能够陪爱人一起奋斗，也能够和爱人一起柴米油盐。2、温文尔雅:俗话说腹中有诗气自华，你就是这种温文尔雅的女生。因为对待事情都比较冷静理智，所以你总是能够给人一种优雅温文的感觉，这种感觉是别人无论如何也不能够带来的。3、力争上游:你虽然身处在各种不同的环境，从事着各种不同的行业；你力争上游的意念是不会改变的。那是你个性上最大的特点。 你从来不会自甘堕落，在你的心里，只有前进，从来不轻易认输。4、善良体贴:你有着传统的家庭观念，对于自己的家人，有着相当程度的忠诚。  你是最善良的人，体贴负责为你着想，不抱怨不埋怨，好姑娘。5、淡定自立:你凡事喜欢靠自己，认为没有任何人有义务去帮你，能自己完成的就不要去麻烦别人，即使对于自己有些困难的事也要一拼到底。缺点：1、刻板无趣:你是名副其实的“不苟言笑”者。你有时候可能被称为女汉子，男人婆一类的，这是因为你大多数都是事业型的，很强悍的那种。2、过度犹豫:你平常总是很让人纠结，一点小事都可能会犹豫不决，例如今晚吃什么，你可能就纠结好久，更别提某些大事了，要你下决策的话，绝对能够逼死人，当然这也是你谨慎的体现，只是太优柔寡断了也不太好。3、思想传统而自卑：你有着传统守旧的思想，很多时候会因为思想传统刻板而产生自卑心态。你通常是在一个大家庭或者团体里面扮演一个严肃有原则且公平的领导者，长期的封闭会让你有些自卑。4、无法承受失败：你太努力，太现实，太自信，所以失败会让你失落很久，无法接受失败的痛和事实，比较悲观，从而也导致失去了许多生活的乐趣。5、没有主见：很多时候你都比较没有主见，没有主见就意味着很多事情都要其他人操心，要其他人做决定。这样的生活会特别容易累。大概是你的男友也是这样子，当然如果男友是像一些男人那样霸道喜欢帮女友做决定的还好，但是其他男生就不一定了。所以你要自己学会做主，让自己变得有主见起来。","pfen":0},"ren":{"num":25,"wu":"土","info":"      数理值：25      签语：(英俊)：资性英敏的刚毅数。(大吉)      详解：　　基业：君臣、首领、福星、文昌、企业、财禄、技艺、财库、进田。　　健康：健康自在，三才善良者可望长寿。　　含义：资性英敏，有奇特的才智， 唯性情不平衡而偏重于一方，言语多少有点棱角柔中带硬，或者有怪脾气，是故涵养不足者，多成怪人，与外人打交道缺谦虚。以英俊之才，自有克成大业。倘任意气用事傲慢无礼，恐弄吉成凶。","pfen":25},"di":{"num":15,"wu":"土","info":"      数理值：15      签语：(福寿)：福寿共照的立身家数。(大吉)      详解：　　基业：天官、贵人、福星、官禄、进田、畜产。　　家庭：清静家田，园满之象子孙昌盛。　　健康：海底明珠，安稳徐庆，健康自如。　　含义：此数为最大好运，福寿园满之象，顺和、雅量。多受福泽，德高望重，自成大业，富贵荣华，吉祥有德，繁荣兴家的大吉数。","pfen":25},"wai":{"num":15,"wu":"土","info":"      数理值：15      签语：(福寿)：福寿共照的立身家数。(大吉)      详解：　　基业：天官、贵人、福星、官禄、进田、畜产。　　家庭：清静家田，园满之象子孙昌盛。　　健康：海底明珠，安稳徐庆，健康自如。　　含义：此数为最大好运，福寿园满之象，顺和、雅量。多受福泽，德高望重，自成大业，富贵荣华，吉祥有德，繁荣兴家的大吉数。","pfen":25},"zong":{"num":25,"wu":"土","info":"      数理值：25      签语：(英俊)：资性英敏的刚毅数。(大吉)      详解：　　基业：君臣、首领、福星、文昌、企业、财禄、技艺、财库、进田。　　健康：健康自在，三才善良者可望长寿。　　含义：资性英敏，有奇特的才智， 唯性情不平衡而偏重于一方，言语多少有点棱角柔中带硬，或者有怪脾气，是故涵养不足者，多成怪人，与外人打交道缺谦虚。以英俊之才，自有克成大业。倘任意气用事傲慢无礼，恐弄吉成凶。","pfen":25}},"sancai":{"config":"木土土","info":"木土土的三才配置数理吉凶详解：吉虽易产生不平、不满之念，招致家庭不和，但幸因知机，而养成（仁德雅量）而能亨通安详，总之大体平顺幸福，而必有相当之成就，只因成功运受到压制，故成功之后，恐难再伸展。成功运被压抑,不能有所伸张，生不平不满之念，招致家庭不和或不幸，有呼吸器官、眼睛疾患。木土土的三才配置数理总论：凶1、总论：发展性很小，切勿好高骛远，以免为钱财起纠纷，家庭生活能无忧就该满足，不要不平不满，注重精神生活才是聪明人。2、性格：表面乐观，内心苦闷，常有不平不满之心理，待人诚实而自劳，喜批评人家是非，自己却容易被煽动。3、意志：意志尚称坚定，但缺乏果断力，处事容易冲动，情绪苦闷又不安定。4、事业：一生辛勤而收获不多，常在忧愁中度日，六亲又难相助。5、家庭：与父母意见不和，夫妻表面平顺，但时常争吵，家内不太平安。6、婚姻：男娶勤俭之妻，夫妻常为小事闹意见；女嫁好胜好强之夫，婚姻不太美满。7、子女：子女运佳，责任心重，能在社会上成功。8、社交：待人诚恳有雅量，但要领不佳，常有受累之事发生，少管闲事为妙。9、精神：为朋友之事及金钱问题操心，心性欠开朗。10、财运：与金钱缘薄，纵有积蓄也有限。11、健康：易患胃肠病，筋骨酸痛。神经质。12、老运：运限平稳，但财源不佳，应注重精神修养。木土土的三才配置性格吉凶：性格稍有迟钝，稳重，易亲近也易离开，成功虽然较迟，但总体上是幸福的。基础运：吉虽有不平不满之状，但以本来的德量，可无大碍，易患肠胃和腹部之症。成功运：凶性情温和周到，善于社交，缺乏牺牲精神。如精心打下良好基础，大发展，大成功。如听之任之，则失去一半的机会。人际关系：吉心多洗练，容易亲近。温和沉着，有雅量，对人有同情心，荣誉心强。属于能享受家庭的命运。其内心有刚义之肠，却不显现于外表。其易亲近的反面又有易疏冷的缺点,其嫉妒心稍强。","pfen":12},"char_info":{"xs_a":{"id":"2311","jianti":"张","fanti":"張","sum":"11","stroke":"5153154","unicode":"U+5F20","gb":"D5C5","wux":"火","pin":"","bushou":"","yi":"","pass":"2"},"xs_b":null,"mz_a":{"id":"1120","jianti":"华","fanti":"華","sum":"14","stroke":"323512","unicode":"U+534E","gb":"BBAA","wux":"水","pin":"huá","bushou":"十","yi":"☆[ huá ]\r☆美丽而有光彩的：～丽。～艳。～彩。～贵。～章。～表（亦称“桓表”）。～盖。\r☆精英：精～。含英咀（jǔ）～。\r☆开花：～而不实。春～秋实。\r☆繁盛：繁～。荣～富贵。\r☆奢侈：浮～。奢～。\r☆指中国或汉族：～夏。中～。～裔。～胄（ａ．华夏的后裔；ｂ．贵族的后裔）。～工。\r☆敬辞，用于跟对方有关的事物：～翰（称人书信）。～诞（称人生日）。～居（称人住宅）。\r☆头发花白：～发（fà）。～颠（指年老）。\r☆指时光：年～。韶～。\r☆[ huà ]\r☆〔～山〕山名，在中国陕西省。\r☆姓。\r☆[ huā ]\r☆古同“花”，花朵。","pass":"1"},"mz_b":null}},"time":1785506522}

失败返回示例：

{"code":0,"msg":"请提供姓(xs)和名(mz)参数","data":[],"time":1785506486}

返回参数说明

参数名 类型 说明
name string 完整姓名，如"张华"
xs string 姓氏，如"张"
mz string 名字，如"华"
score integer 综合评分（满分100）
score_desc string 评分描述/评语
num integer 数理值
wu string 五行属性（金/木/水/火/土）
info string 详细解释（HTML格式）
pfen integer 评分（0-25分）
config string 三才配置组合，如"木土土"
info string 三才配置详细解释（HTML格式），包含基础运、成功运、人际关系等
pfen integer 三才评分
xs_a object 姓氏汉字信息
xs_b object 复姓第二个字（单姓为null）
mz_a object 名字第一个汉字信息
mz_b object 名字第二个字（单名为null）
id string 汉字编号
jianti string 简体字
fanti string 繁体字
sum string 笔画数
stroke string 笔顺数字
unicode string Unicode编码
gb string GB2312编码
wux string 五行属性
pin string 拼音
bushou string 部首
yi string 字义解释
pass string 是否常用字（1=是，2=否）

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=namescore?key=SK-你的密钥&xs=%E5%BC%A0&mz=%E4%BC%9F"

错误响应

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

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

注意事项

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

开发时间

2026-09-24