八字合盘 API

POST/api/v1/chinese/bazi/synastry

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

完整 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	Yes	Person A 的完整 Bazi Request 对象。
person_b	object	Yes	Person B 的完整 Bazi Request 对象。

注意：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"
    }
}'

响应数据

{
  "score": 78,
  "overall_compatibility": "Highly Compatible",
  "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": "Combination (Attraction)",
    "score": 95,
    "description": "Strong magnetic attraction. 甲-己 combine to form Earth.",
    "dynamic": "Destined"
  },
  "spouse_palace_analysis": {
    "branch_a": "子",
    "branch_b": "丑",
    "interaction": "Six-Harmony",
    "score": 65,
    "description": "Day Branches 子 and 丑: Six-Harmony.",
    "type": "Harmony"
  },
  "element_analysis": {
    "score": 80,
    "details": [
      "Person B has strong Water (60%) to support Person A.",
      "Person A provides moderate Wood support to Person B."
    ],
    "a_needs": "Water",
    "b_needs": "Wood"
  },
  "conflict_scan": {
    "clashes": 0,
    "harms": 0,
    "punishments": 0,
    "destructions": 0
  },
  "conflict_summary": "No major destructive interactions detected. Structurally stable."
}