八字关系合参（异步任务）

支持分别填写双方出生资料，适合双人传统文化解读与关系主题的阅读产品。

双方可独立选择公历或农历并标明闰月，无需先把两份出生记录手工换算成同一历法。

分别返回双方的公农历换算和四柱排盘，便于在双栏页面中核对每个人的基础资料。

可提交关系关注方向，让文化解读围绕沟通方式、价值观或长期相处等指定主题展开。

返回整体关系摘要与关键词，适合在结果页顶部呈现阅读提要并连接完整解读章节。

按维度提供双方互补特点及相应说明，便于制作分项阅读卡片并保留具体解释。

分别列出适合的沟通方式与需要避免的情形，帮助读者区分不同类型的文化建议。

提供长期相处建议和注意事项，可作为关系主题文章或报告中的独立阅读章节。

双方资料支持统一选择简体中文、繁体中文或英文，以对应同一份报告的阅读语言。

支持同步、异步任务与流式获取，便于在完整报告和逐步阅读两种产品体验中使用。

相关解读仅供娱乐、传统文化研究与参考，不代表经科学验证的预测，不应作为医疗、法律、投资、婚姻或职业等重要现实决策的唯一依据。

当前接口契约

接口详情：https://www.gugudata.com/api/details/bazi-relationship-insight

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	支持 Query、X-GUGUDATA-APPKEY、Bearer 或 JSON body。 AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。
personA	object	是	N/A	甲方完整出生资料对象。
personB	object	是	N/A	乙方完整出生资料对象。
personA.name	string	否	N/A	可选称呼，最多 50 个字符。
personA.gender	string	是	无	支持男、女及常见英文写法。
personA.calendarType	string	是	无	支持公历、农历及英文写法。
personA.birthDate	string	是	无	出生日期，范围 1901-01-01 至 2100-12-31。
personA.birthTime	string	是	无	24 小时制出生时间。
personA.birthPlace	string	否	N/A	可选出生地点，最多 100 个字符。
personA.isLeapMonth	boolean	否	false	仅农历日期可设置为 true。
personA.language	string	否	zh-CN	双方必须一致，支持 zh-CN、zh-TW、en-US。
personB.name	string	否	N/A	可选称呼，最多 50 个字符。
personB.gender	string	是	无	支持男、女及常见英文写法。
personB.calendarType	string	是	无	支持公历、农历及英文写法。
personB.birthDate	string	是	无	出生日期，范围 1901-01-01 至 2100-12-31。
personB.birthTime	string	是	无	24 小时制出生时间。
personB.birthPlace	string	否	N/A	可选出生地点，最多 100 个字符。
personB.isLeapMonth	boolean	否	false	仅农历日期可设置为 true。
personB.language	string	否	zh-CN	双方必须一致，支持 zh-CN、zh-TW、en-US。
focusAreas	array	否	[]	1～6 个关注方向，每项最多 20 字；空数组使用默认方向。
responseMode	string	否	sync	支持 sync 或 task。
streaming	boolean	否	false	SSE 仅支持同步模式。

正常响应字段

字段	类型	说明
DataStatus.StatusCode	integer	业务码，100 表示成功。
DataStatus.StatusDescription	string	业务状态说明。
Data.基础数据	object	双方出生资料、真实历法换算与关注方向。
Data.基础数据.甲方.排盘基础	object	甲方标准化输入、历法换算、四柱和八字。
Data.基础数据.乙方.排盘基础	object	乙方标准化输入、历法换算、四柱和八字。
Data.文化解读	object	固定结构的关系文化解读。
Data.免责声明	string	文化研究与娱乐参考边界。
Data.operationId	string	任务模式的任务标识。
Data.status	string	任务状态。
Data.pollingUrl	string	任务状态查询地址。
Data.result	object	任务成功时的完整结果。
Data.error	object	任务失败信息。
SSE.done.result	object	流式完成事件的完整已校验结果。

业务状态说明

业务状态码	业务状态码解释	备注
100	请求成功	HTTP 200
501	参数错误	HTTP 400
502	请求频率受限	HTTP 429
503	订单已到期	HTTP 403
504	APPKEY 错误	HTTP 401，包含缺少 APPKEY
505	调用额度耗尽	HTTP 403
900	内部错误	HTTP 500
901	依赖服务不可用	HTTP 503

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

Header 参数

Body 参数application/json必填

示例

{
  "personA": {
    "gender": "男",
    "calendarType": "公历",
    "birthDate": "1990-12-01",
    "birthTime": "07:30:00",
    "language": "zh-CN"
  },
  "personB": {
    "gender": "女",
    "calendarType": "公历",
    "birthDate": "1992-06-15",
    "birthTime": "09:20:00",
    "language": "zh-CN"
  },
  "focusAreas": [
    "沟通方式",
    "价值观"
  ],
  "responseMode": "task",
  "streaming": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

请求成功（业务码 100）。

Bodyapplication/json

示例

{
    "DataStatus": {
        "ResponseDateTime": "string",
        "DataTotalCount": 0,
        "RequestParameter": "string",
        "StatusDescription": "string",
        "StatusCode": 0
    },
    "Data": {
        "基础数据": {
            "甲方": {
                "出生资料": {
                    "property1": "string",
                    "property2": "string"
                },
                "历法计算": {
                    "property1": "string",
                    "property2": "string"
                },
                "排盘基础": {
                    "输入信息": {
                        "property1": "string",
                        "property2": "string"
                    },
                    "历法换算": {
                        "property1": "string",
                        "property2": "string"
                    },
                    "四柱": {
                        "年柱": "string",
                        "月柱": "string",
                        "日柱": "string",
                        "时柱": "string"
                    },
                    "八字": "string"
                }
            },
            "乙方": {
                "出生资料": {
                    "property1": "string",
                    "property2": "string"
                },
                "历法计算": {
                    "property1": "string",
                    "property2": "string"
                },
                "排盘基础": {
                    "输入信息": {
                        "property1": "string",
                        "property2": "string"
                    },
                    "历法换算": {
                        "property1": "string",
                        "property2": "string"
                    },
                    "四柱": {
                        "年柱": "string",
                        "月柱": "string",
                        "日柱": "string",
                        "时柱": "string"
                    },
                    "八字": "string"
                }
            },
            "关注方向": [
                "string"
            ]
        },
        "文化解读": {
            "关系摘要": {
                "整体倾向": "string",
                "关系关键词": [
                    "string"
                ],
                "核心观察": "string"
            },
            "互补特点": [
                {
                    "维度": "string",
                    "解读": "string"
                }
            ],
            "沟通建议": {
                "适合方式": [
                    "string"
                ],
                "需要避免": [
                    "string"
                ]
            },
            "长期相处建议": [
                "string"
            ],
            "注意事项": [
                "string"
            ]
        },
        "免责声明": "string"
    }
}

🟠400参数错误（业务码 501）。

🟠401APPKEY 错误（业务码 504）。

🟠403订单已到期（业务码 503）；调用额度耗尽（业务码 505）。

🟠404资源不存在。请求路径不存在。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

🟠429请求频率受限（业务码 502）。

🔴500内部错误（业务码 900）。

🔴502数据服务暂时不可用，请稍后重试。

🔴503依赖服务不可用（业务码 901）。

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明