缘分测试API接口文档 GET / POST 娱乐测试

提供双方缘分测试分析服务，根据两人的公历出生年月日时，推算各自的八字排盘、五行分析，并进行缘分匹配度评估，包括性格分析、相处建议。（注意：接入前请查看详情中的免责声明）

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

提供双方缘分测试分析服务，根据两人的公历出生年月日时，推算各自的八字排盘、五行分析，并进行缘分匹配度评估，包括性格分析、相处建议。（注意：接入前请查看详情中的免责声明）

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

缘分测试接口信息

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

调用统计

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

apikey=你的API密钥&myname=请填写myname&birthday=请填写birthday&hour=请填写hour&taname=请填写taname&girl_birthday=请填写girl_birthday&girl_hour=请填写girl_hour

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

缘分测试请求参数

参数名类型必填说明示例
mynamestring是男方姓名（需URL编码）
birthdaystring是男方出生日期（格式：YYYY-MM-DD）
hourinteger是男方出生小时（0-23）
tanamestring是女方姓名（需URL编码）
girl_birthdaystring是女方出生日期（格式：YYYY-MM-DD）
girl_hourinteger是女方出生小时（0-23）
返回示例
{"code":1,"msg":"查询成功","data":{"myname":"张三","taname":"李四","abirthday":{"year":"1990","month":5,"day":15,"hour":10},"bbirthday":{"year":"1992","month":8,"day":20,"hour":14},"a_bazi":{"bazi_str":"庚午 辛巳 己卯 己巳","day_gan":"己","day_wx":"土","wx_score":{"木":7,"火":21,"土":24,"金":24,"水":0}},"b_bazi":{"bazi_str":"壬申 戊申 戊辰 己未","day_gan":"戊","day_wx":"土","wx_score":{"木":3,"火":2,"土":46,"金":14,"水":15}},"result":{"title":"两金夫妻硬对硬...","info":"因此男金命女金命在一起..."}},"time":1786015015}

详细文档

缘分测试 API 接口文档

接口描述

提供双方缘分测试分析服务，根据两人的公历出生年月日时，推算各自的八字排盘、五行分析，并进行缘分匹配度评估，包括性格分析、相处建议。（注意：接入前请查看详情中的免责声明）

功能特性

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

接口地址

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

请求方式

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

鉴权方式

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

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

请求参数

参数名 类型 必填 描述
myname string 是 男方姓名（需URL编码）
birthday string 是 男方出生日期（格式：YYYY-MM-DD）
hour integer 是 男方出生小时（0-23）
taname string 是 女方姓名（需URL编码）
girl_birthday string 是 女方出生日期（格式：YYYY-MM-DD）
girl_hour integer 是 女方出生小时（0-23）

请求参数 (JSON格式)

[
  {"name": "myname", "type": "string", "required": true, "description": "男方姓名（需URL编码）"},
  {"name": "birthday", "type": "string", "required": true, "description": "男方出生日期（格式：YYYY-MM-DD）"},
  {"name": "hour", "type": "integer", "required": true, "description": "男方出生小时（0-23）"},
  {"name": "taname", "type": "string", "required": true, "description": "女方姓名（需URL编码）"},
  {"name": "girl_birthday", "type": "string", "required": true, "description": "女方出生日期（格式：YYYY-MM-DD）"},
  {"name": "girl_hour", "type": "integer", "required": true, "description": "女方出生小时（0-23）"}
]

响应格式

JSON 格式响应

成功返回示例：

{"code":1,"msg":"查询成功","data":{"myname":"张三","taname":"李四","abirthday":{"year":"1990","month":5,"day":15,"hour":10},"bbirthday":{"year":"1992","month":8,"day":20,"hour":14},"a_bazi":{"bazi_str":"庚午 辛巳 己卯 己巳","day_gan":"己","day_wx":"土","wx_score":{"木":7,"火":21,"土":24,"金":24,"水":0}},"b_bazi":{"bazi_str":"壬申 戊申 戊辰 己未","day_gan":"戊","day_wx":"土","wx_score":{"木":3,"火":2,"土":46,"金":14,"水":15}},"result":{"title":"两金夫妻硬对硬...","info":"因此男金命女金命在一起..."}},"time":1786015015}

失败返回示例：

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

返回参数说明

参数名 类型 说明
code integer 状态码，1表示成功
msg string 返回消息，如"查询成功"
data object 缘分测试核心数据对象
time integer 数据生成时间戳（Unix时间戳）
其他参数见接口详情 string 其他参数见接口详情

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=yuanfen?key=SK-你的密钥&myname=%E5%BC%A0%E4%BC%9F&birthday=1993-05-20&hour=10&taname=%E6%9D%8E%E5%A8%9C&girl_birthday=1995-08-15&girl_hour=14"

错误响应

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

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

注意事项

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

开发时间

2026-09-24