订婚吉日查询API接口文档 GET / POST 娱乐测试

输入男女双方姓名、出生日期、时辰，基于协纪辨方书干支轮值算法，并结合查询人生辰八字、生肖冲煞、黄道值神进行筛选适合订婚的黄道吉日。（结果仅供娱乐参考）

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

输入男女双方姓名、出生日期、时辰，基于协纪辨方书干支轮值算法，并结合查询人生辰八字、生肖冲煞、黄道值神进行筛选适合订婚的黄道吉日。（结果仅供娱乐参考）

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

订婚吉日查询接口信息

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

调用统计

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

apikey=你的API密钥&maleName=请填写maleName&maleBirthday=请填写maleBirthday&maleHour=请填写maleHour&femaleName=请填写femaleName&femaleBirthday=请填写femaleBirthday&femaleHour=请填写femaleHour&range=请填写range

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

订婚吉日查询请求参数

参数名类型必填说明示例
maleNamestring是男方姓名
maleBirthdaystring是男方生日，格式 YYYY-MM-DD
maleHourinteger是男方出生时辰（0-23 整数）
femaleNamestring是女方姓名
femaleBirthdaystring是女方生日，格式 YYYY-MM-DD
femaleHourinteger是女方出生时辰（0-23 整数）
rangestring否时间范围：1month（默认）、3months、6months、1year

详细文档

订婚吉日查询 API 接口文档

接口描述

输入男女双方姓名、出生日期、时辰，基于协纪辨方书干支轮值算法，并结合查询人生辰八字、生肖冲煞、黄道值神进行筛选适合订婚的黄道吉日。（结果仅供娱乐参考）

功能特性

  • 输入男女双方姓名、出生日期、时辰，基于协纪辨方书干支轮值算法，并结合查询人生辰八字、生肖冲煞、黄道值神进行筛选适合订婚的…
  • 返回 JSON 结构化数据，便于程序解析
  • 支持 GET / POST 两种调用方式
  • 平台统一密钥鉴权与调用统计，支持积分计费

接口地址

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

请求方式

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

鉴权方式

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

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

请求参数

参数名 类型 必填 描述
maleName string 是 男方姓名
maleBirthday string 是 男方生日，格式 YYYY-MM-DD
maleHour integer 是 男方出生时辰（0-23 整数）
femaleName string 是 女方姓名
femaleBirthday string 是 女方生日，格式 YYYY-MM-DD
femaleHour integer 是 女方出生时辰（0-23 整数）
range string 否 时间范围：1month（默认）、3months、6months、1year

请求参数 (JSON格式)

[
  {"name": "maleName", "type": "string", "required": true, "description": "男方姓名"},
  {"name": "maleBirthday", "type": "string", "required": true, "description": "男方生日，格式 YYYY-MM-DD"},
  {"name": "maleHour", "type": "integer", "required": true, "description": "男方出生时辰（0-23 整数）"},
  {"name": "femaleName", "type": "string", "required": true, "description": "女方姓名"},
  {"name": "femaleBirthday", "type": "string", "required": true, "description": "女方生日，格式 YYYY-MM-DD"},
  {"name": "femaleHour", "type": "integer", "required": true, "description": "女方出生时辰（0-23 整数）"},
  {"name": "range", "type": "string", "required": false, "description": "时间范围：1month（默认）、3months、6months、1year"}
]

响应格式

JSON 格式响应

返回参数说明

参数名 类型 说明
返回参数见接口详情 string 返回参数见接口详情

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=dinghunday?key=SK-你的密钥&maleName=%E5%BC%A0%E4%BC%9F&maleBirthday=1993-05-20&maleHour=10&femaleName=%E6%9D%8E%E5%A8%9C&femaleBirthday=1995-08-15&femaleHour=14"

错误响应

上游业务级错误：

code msg 描述
400 invalid_name 姓名未填写
400 invalid_birthday 生日格式错误，请使用 YYYY-MM-DD
400 invalid_hour 出生时辰未填写或不在 0-23 范围内

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

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

注意事项

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

开发时间

2026-09-24