姓名配对API接口文档 GET / POST 娱乐测试

提供两人姓名五行配对分析服务,根据双方姓名的五行属性,分析性格互补、缘分深浅、相处模式、家庭稳固度及婚姻长久度,并给出相处建议。(注意:接入前请查看详情中的免责声明)

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

提供两人姓名五行配对分析服务,根据双方姓名的五行属性,分析性格互补、缘分深浅、相处模式、家庭稳固度及婚姻长久度,并给出相处建议。(注意:接入前请查看详情中的免责声明)

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

姓名配对接口信息

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

调用统计

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

apikey=你的API密钥&myname=请填写myname&taname=请填写taname

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

姓名配对请求参数

参数名类型必填说明示例
mynamestring己方姓名
tanamestring对方姓名
返回示例
{"code":1,"msg":"查询成功","data":{"myname":"李华","taname":"李欢","my_wuxing":"木","ta_wuxing":"水","result":{"title":"水生木,木涵水,彼此滋养,方能根深叶茂,白头偕老","info":"当一方命理中五行木气偏重、水生木,木涵水,彼此滋养,方能根深叶茂,白头偕老。"}},"time":1786087920}

详细文档

姓名配对 API 接口文档

接口描述

提供两人姓名五行配对分析服务,根据双方姓名的五行属性,分析性格互补、缘分深浅、相处模式、家庭稳固度及婚姻长久度,并给出相处建议。(注意:接入前请查看详情中的免责声明)

功能特性

  • 提供两人姓名五行配对分析服务,根据双方姓名的五行属性,分析性格互补、缘分深浅、相处模式、家庭稳固度及婚姻长久度,并给出相…
  • 返回 JSON 结构化数据,便于程序解析
  • 支持 GET / POST 两种调用方式
  • 平台统一密钥鉴权与调用统计,支持积分计费

接口地址

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

请求方式

GET / POST(业务参数 GET 通过 URL 传递,POST 支持表单或 JSON)

鉴权方式

调用需携带平台密钥(用户中心「令牌管理」获取,SK- 开头):

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

请求参数

参数名 类型 必填 描述
myname string 己方姓名
taname string 对方姓名

请求参数 (JSON格式)

[
  {"name": "myname", "type": "string", "required": true, "description": "己方姓名"},
  {"name": "taname", "type": "string", "required": true, "description": "对方姓名"}
]

响应格式

JSON 格式响应

成功返回示例:

{"code":1,"msg":"查询成功","data":{"myname":"李华","taname":"李欢","my_wuxing":"木","ta_wuxing":"水","result":{"title":"水生木,木涵水,彼此滋养,方能根深叶茂,白头偕老","info":"当一方命理中五行木气偏重、水生木,木涵水,彼此滋养,方能根深叶茂,白头偕老。"}},"time":1786087920}

失败返回示例:

{"code":0,"msg":"请提供双方姓名参数(myname, taname)","data":null,"time":1786087895}

返回参数说明

参数名 类型 说明
code integer 状态码,1表示成功
msg string 返回消息,如"查询成功"
data object 姓名配对核心数据对象
time integer 数据生成时间戳(Unix时间戳)

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=namepeidui?key=SK-你的密钥&myname=%E5%BC%A0%E4%BC%9F&taname=%E6%9D%8E%E5%A8%9C"

错误响应

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

失败时请以响应体中的 code / errcodemsg 判断。

注意事项

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

开发时间

2026-09-24