紫微斗数五行局与命主身主解读：wx / mz / sz / sx 字段含义
# 紫微斗数五行局与命主身主解读：wx / mz / sz / sx 字段含义
> 接口/接入点：紫微斗数排盘（apiCode=1647，接入点 1） · 免费 · 返回 JSON · 适用人群：命理研究者、开发者 · 阅读时间约 6 分钟
## 核心要点
- 命盘顶层（非 `pan`）有几个「全局标识」字段：`wx`（五行局）、`mz`（命主）、`sz`（身主）、`sg`（身宫）、`yy`（阴阳）、`sx`（生肖）。
- `wx` 如「火6局」表示命盘所属的五行局与局数；`mz`/`sz` 是命主/身主星；`sg` 是身宫所在宫位；`yy` 是阴/阳男/女；`sx` 是生肖。
- 这些字段属传统文化研究的结构化输出，接口定位为研究参考工具。
## Why：这几个顶层字段有什么用
`result` 顶层除了 `pan`（十二宫），还有一组「全局标签」，用来描述整张命盘的基调（五行局、命主、身主、阴阳、生肖、身宫）。做展示时，把它们放在命盘顶部作为概览，用户一眼能看到这张盘的关键标识。本文逐一解释。
## What：字段速览
| 字段 | 类型 | 含义 | 示例 |
|------|------|------|------|
| `wx` | String | 五行局（含局数） | 火6局 |
| `mg` | String | 命宫宫位 | 子 |
| `mz` | String | 命主 | 贪狼 |
| `yy` | String | 阴阳（阴男/阳男/阴女/阳女） | 阴女 |
| `sz` | String | 身主 | 天相 |
| `sg` | String | 身宫所在宫位 | 子 |
| `sx` | String | 生肖 | 羊 |
> 注：`mg`（命宫）与 `sg`（身宫）是宫位名，`mz`/`sz` 是主星名，注意区分。
## How：读取顶层标识
**Python**
```python
import requests
url = "https://route.showapi.com/1647-1"
params = {"appKey": "YOUR_APPKEY"}
data = {"time": "1993-10-27 06", "gender": "m"}
res = requests.post(url, params=params, data=data, timeout=10).json()["showapi_res_body"]
if res.get("ret_code") != 0:
raise SystemExit(res.get("remark"))
r = res["result"]
print(f"五行局={r['wx']} 命主={r['mz']} 身主={r['sz']} 阴阳={r['yy']} 生肖={r['sx']} 身宫={r['sg']}")
```
**cURL**
```bash
curl -X POST "https://route.showapi.com/1647-1?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "time=1993-10-27%2006&gender=m"
```
**Node.js（fetch）**
```javascript
const url = "https://route.showapi.com/1647-1?appKey=YOUR_APPKEY";
const body = new URLSearchParams({ time: "1993-10-27 06", gender: "m" });
const data = await (await fetch(url, {
method: "POST", headers: { "content-type": "application/x-www-form-urlencoded" }, body,
})).json();
const r = data.showapi_res_body.result;
console.log(r.wx, r.mz, r.sz, r.yy, r.sx, r.sg);
```
## 返回示例与解析
官方示例（注意：示例请求 `gender=m`，返回 `yy` 为「阴女」，属示例数据本身的口径，实际以你的入参对应结果为准）：
```json
{
"wx": "火6局", "mg": "子", "mz": "贪狼", "yy": "阴女",
"sz": "天相", "sg": "子", "sx": "羊"
}
```
- `wx`（五行局）：紫微斗数按出生年干支起局，分水/木/金/土/火五行局，并带局数（如「火6局」）。
- `mz`（命主）/ `sz`（身主）：由五行局决定的主星，是命盘的重要标识。
- `yy`（阴阳）：由出生年天干阴阳与性别组合，分阴男/阳男/阴女/阳女，影响排盘顺逆。
- `sg`（身宫）：身宫所在的宫位名，与命宫共同反映先天与后天。
- `sx`（生肖）：由出生年决定的生肖。
## 进阶 / 边界
- **示例口径不一致提醒**：官方返回示例中请求 `gender=m` 但 `yy` 显示为「阴女」，属示例数据问题；实际调用请以你传入的 `time`/`gender` 对应的返回为准，不要据此推断性别与阴阳的映射。
- **仅返回标识，不解释命理**：接口给的是结构化标签，具体命理含义属研究范畴，本文不作断言。
- **合规标注**：面向用户展示时注明「传统文化研究参考，结果仅供参考」。
## FAQ
**Q1：wx 的「局数」是指什么？**
A：`wx` 如「火6局」由出生年干支依五行局规则推算，包含五行属性与局数，是命盘起盘的基础标识之一，具体推算规则属命理学范畴。
**Q2：命主(mz)和身主(sz)有什么不同？**
A：命主由五行局决定、与命宫关联；身主同样由五行局决定、与身宫关联。二者是命盘的两个核心主星标识，接口原样返回。
**Q3：sg（身宫）和 mg（命宫）哪个更重要？**
A：命宫反映先天特质、身宫反映后天作为，二者并列重要。接口同时返回，展示时建议都保留。
**Q4：阴阳(yy)和性别(gender)是一回事吗？**
A：不是。性别是输入参数（m/f），阴阳（阴男/阳男/阴女/阳女）是由出生年天干阴阳与性别共同决定的排盘属性，影响起盘顺逆。
## 相关能力 / 下一步阅读
- [紫微斗数排盘API返回字段全解：五行局、十二宫、主星一文读懂](https://www.showapi.com/guides/ziwei-doushu-response-fields-1647)
- [紫微斗数十二宫详解：命宫、财帛、事业等 12 宫字段怎么读](https://www.showapi.com/guides/ziwei-doushu-twelve-palaces-1647)
- [紫微斗数大限与小限解读：bLimit / sLimit 字段推算人生阶段](https://www.showapi.com/guides/ziwei-doushu-limit-interpret-1647)
- **本系列共 12 篇**：查看[紫微斗数排盘 API 指南总目录](https://www.showapi.com/guides/ziwei-doushu-guides-1647)
