BaZi Dictionary API 文档 | FreeAstroAPI 中文说明

BaZi 字典 API

GET/api/v1/chinese/bazi/dictionary

该接口返回 BaZi Flow 等接口使用的 ID 映射表。你可以在应用启动时缓存它，再把 Flow 响应里的整数 ID 解析成可读的作用关系、神煞和中文术语。

中文响应与兼容性约定

使用 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/dictionary

ID 范围

ID 范围	类型	示例
1000-1999	Stem Combinations	甲-己合, 乙-庚合, etc.
2000-2999	Branch Clashes	子午冲, 丑未冲, etc.
3000-3099	Six Harmonies	子丑合, 寅亥合, etc.
3100-3199	Three Harmonies	寅午戌, 申子辰, etc.
3200-3299	Harms (Hai)	子未害, 丑午害, etc.
3300-3399	Breaks (Po)	子酉破, 丑辰破, etc.
3400-3499	Punishments (Xing)	寅巳申刑, etc.
4000-4999	Stars (Shen Sha)	天乙贵人, 桃花, etc.

请求参数

这是一个没有参数的 GET 请求。只需要在 header 中提供 API key。

调用示例

curl -X GET "https://api.freeastroapi.com/api/v1/chinese/bazi/dictionary?lang=zh-CN" \
 -H "x-api-key: YOUR_API_KEY"

响应示例

{
  "1000": {
    "type": "天干合",
    "name": "甲己合",
    "name_zh": "甲己合",
    "stems": ["甲", "己"],
    "transform_to": "土",
    "description": "甲木与己土相合，条件满足时可化为土。"
  },
  "2000": {
    "type": "地支六冲",
    "name": "子午冲",
    "name_zh": "子午冲",
    "branches": ["子", "午"],
    "elements": ["水", "火"],
    "description": "子午相冲，呈现水火对立。"
  },
  "3000": {
    "type": "地支六合",
    "name": "子丑合",
    "name_zh": "子丑合",
    "branches": ["子", "丑"],
    "transform_to": "土"
  },
  "4000": {
    "name": "天乙贵人",
    "name_zh": "天乙贵人",
    "id": "star_nobleman",
    "category": "吉神",
    "description": "最强的保护性神煞，象征贵人扶助。"
  }
}