返回中文文档
八字合盘 API

八字合盘 API

POST/api/v1/chinese/bazi/synastry

这是一个专业级八字合盘引擎，超越简单的生肖匹配。它会分析日主动态（互补关系）、夫妻宫连接（刑害关系）、五行资源供给（需求与消耗），以及隐藏的业力连接。

中文响应与兼容性约定

使用 lang: "zh-CN"（POST 请求体）或?lang=zh-CN（GET 查询参数）请求简体中文响应。zh-Hans、zh 和zh_hans 也会归一化为同一书写语言。

面向用户的名称、说明、星期、五行、生肖、十神和错误消息会本地化。为避免破坏现有客户端， JSON 字段名、对象映射键、稳定 ID、错误代码、枚举值、模式值、ISO 时间戳、时区、库名、版本号和拼音保持不变。 客户端应依据字段名与稳定代码处理逻辑，不要依据翻译后的显示文本建立判断。

例如 ten_god_distribution 内的Direct Wealth 等映射键属于兼容性标识，仍使用英文；页面标题、说明、描述和独立显示值会返回中文。

完整 URL

https://api.freeastroapi.com/api/v1/chinese/bazi/synastry

引擎能力

Day Master Reciprocity

分析超越简单匹配的“给予者 vs 接收者”动态。

Spouse Palace Deep Dive

检查 Harm、Punishment 和共享共振。

Evaluative Element Supply

检查伴侣是否触发“Draining”或“Supportive”流动。

Conflict Synthesis

对 destructive patterns 做叙事汇总，例如“Internalized Tension”。

Hidden Interaction Scan

检测隐藏在地支内部的 karmic links。

请求参数

字段
person_a
类型
object
必填
是
说明
A 方的完整 Bazi Request 对象。
字段
person_b
类型
object
必填
是
说明
B 方的完整 Bazi Request 对象。
字段
lang
类型
string
必填
否
说明
顶层语言设置。使用 zh-CN 返回简体中文。
注意：person_a 和 person_b 对象都接受标准 Bazi Request 字段 （year、month、day、hour、lat/lng、sex 等）。

调用示例

curl -X POST "https://api.freeastroapi.com/api/v1/chinese/bazi/synastry" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
    "person_a": {
        "year": 1990, "month": 5, "day": 15, "hour": 10, "minute": 30,
        "lat": 28.6139, "lng": 77.2090, "city": "Person A", "sex": "M"
    },
    "person_b": {
        "year": 1992, "month": 8, "day": 20, "hour": 14, "minute": 15,
        "lat": 40.7128, "lng": -74.0060, "city": "Person B", "sex": "F"
    },
    "lang": "zh-CN"
}'

响应数据

{
  "score": 78,
  "overall_compatibility": "高度相合",
  "score_breakdown": {
    "day_master": 23.8,
    "spouse_palace": 15,
    "pillars": 22.5,
    "elements": 12,
    "hidden_bonus": 4.5
  },
  "day_master_analysis": {
    "dm_a": "甲",
    "dm_b": "己",
    "relation": "天干相合（吸引）",
    "score": 95,
    "description": "甲—己天干相合，有化土的倾向，吸引力较强。",
    "dynamic": "缘分感强"
  },
  "spouse_palace_analysis": {
    "branch_a": "子",
    "branch_b": "丑",
    "interaction": "六合",
    "score": 65,
    "description": "日支子与丑：六合。",
    "type": "合"
  },
  "element_analysis": {
    "score": 80,
    "details": [
      "乙方的水较强（60%），可为甲方提供支持。",
      "甲方为乙方提供中等程度的木支持。"
    ],
    "a_needs": "水",
    "b_needs": "木"
  },
  "conflict_scan": {
    "clashes": 0,
    "harms": 0,
    "punishments": 0,
    "destructions": 0
  },
  "conflict_summary": "未发现重大的破坏性作用，结构较为稳定。"
}