{
    "八字择吉接口规范": {
        "接口名称": "八字择吉测算",
        "接口路径": "/api/v1/yifan/yifan_bazi_zeji/calculate",
        "请求方法": "POST",
        "入参 (Request)": {
            "name": {
                "type": "string",
                "required": true,
                "description": "姓名",
                "example": "王召阳"
            },
            "gender": {
                "type": "string",
                "required": true,
                "description": "性别",
                "enum": [
                    "male",
                    "female"
                ],
                "enum_labels": {
                    "male": "男",
                    "female": "女"
                }
            },
            "birth_date": {
                "type": "string",
                "required": true,
                "description": "生辰八字（显示格式）",
                "example": "1999年11月15日 子时"
            },
            "birth_date_api": {
                "type": "string",
                "required": true,
                "description": "生辰八字（API格式）",
                "format": "YYYY-MM-DD HH:mm:ss",
                "example": "1999-11-15 00:30:00"
            },
            "birth_place": {
                "type": "string",
                "required": true,
                "description": "出生地",
                "example": "临沂市"
            },
            "zeji_type": {
                "type": "string",
                "required": true,
                "description": "择吉类型",
                "enum": [
                    "wedding",
                    "business",
                    "move",
                    "travel",
                    "investment",
                    "surgery",
                    "contract",
                    "other"
                ],
                "enum_labels": {
                    "wedding": "婚嫁择吉（结婚、订婚、求婚）",
                    "business": "开业择吉（开店、公司成立、项目启动）",
                    "move": "搬家择吉（搬迁、入宅、装修）",
                    "travel": "出行择吉（旅游、出差、远行）",
                    "investment": "投资择吉（投资、理财、购买）",
                    "surgery": "手术择吉（医疗手术、体检）",
                    "contract": "签约择吉（合同签署、协议达成）",
                    "other": "其他择吉（其他重要事项）"
                }
            },
            "zeji_purpose": {
                "type": "string",
                "required": true,
                "description": "择吉目的描述",
                "example": "选择结婚吉日，希望婚姻美满幸福"
            },
            "date_range_start": {
                "type": "string",
                "required": true,
                "description": "期望日期范围开始",
                "format": "YYYY-MM-DD",
                "example": "2026-05-01"
            },
            "date_range_end": {
                "type": "string",
                "required": true,
                "description": "期望日期范围结束",
                "format": "YYYY-MM-DD",
                "example": "2027-05-01"
            }
        },
        "入参示例": {
            "name": "王召阳",
            "gender": "male",
            "birth_date": "1999年11月15日 子时",
            "birth_date_api": "1999-11-15 00:30:00",
            "birth_place": "临沂市",
            "zeji_type": "wedding",
            "zeji_purpose": "选择结婚吉日，希望婚姻美满幸福",
            "date_range_start": "2026-05-01",
            "date_range_end": "2027-05-01"
        },
        "出参 (Response)": {
            "code": {
                "type": "number",
                "description": "状态码，200表示成功"
            },
            "msg": {
                "type": "string",
                "description": "返回消息"
            },
            "data": {
                "type": "object",
                "description": "八字择吉结果数据",
                "properties": {
                    "name": {
                        "type": "string",
                        "description": "姓名",
                        "example": "王召阳"
                    },
                    "gender": {
                        "type": "string",
                        "description": "性别",
                        "example": "male"
                    },
                    "birth_date": {
                        "type": "string",
                        "description": "生辰八字",
                        "example": "1999年11月15日 子时"
                    },
                    "birth_place": {
                        "type": "string",
                        "description": "出生地",
                        "example": "临沂市"
                    },
                    "zeji_type": {
                        "type": "string",
                        "description": "择吉类型",
                        "example": "wedding"
                    },
                    "zeji_purpose": {
                        "type": "string",
                        "description": "择吉目的",
                        "example": "选择结婚吉日，希望婚姻美满幸福"
                    },
                    "date_range_start": {
                        "type": "string",
                        "description": "日期范围开始",
                        "example": "2026-05-01"
                    },
                    "date_range_end": {
                        "type": "string",
                        "description": "日期范围结束",
                        "example": "2027-05-01"
                    },
                    "advice": {
                        "type": "string",
                        "description": "择吉建议",
                        "example": "红鸾星动，天喜临门。本月利于婚嫁，宜选双日，寓意成双成对。忌选父母生辰冲克之日。"
                    },
                    "dates": {
                        "type": "array",
                        "description": "吉日列表",
                        "items": {
                            "type": "object",
                            "properties": {
                                "date": {
                                    "type": "string",
                                    "description": "日期",
                                    "example": "2026-05-18"
                                },
                                "lunar": {
                                    "type": "string",
                                    "description": "农历日期",
                                    "example": "四月十一"
                                },
                                "desc": {
                                    "type": "string",
                                    "description": "日期描述",
                                    "example": "天德合日，官印相生"
                                },
                                "score": {
                                    "type": "number",
                                    "description": "吉运指数",
                                    "example": 98,
                                    "range": "0-100"
                                },
                                "hours": {
                                    "type": "string",
                                    "description": "吉时",
                                    "example": "巳时(09-11), 未时(13-15)"
                                },
                                "clash": {
                                    "type": "string",
                                    "description": "冲煞",
                                    "example": "冲猪"
                                },
                                "suitable": {
                                    "type": "array",
                                    "description": "宜",
                                    "items": {
                                        "type": "string"
                                    },
                                    "example": [
                                        "嫁娶",
                                        "开市",
                                        "出行"
                                    ]
                                },
                                "avoid": {
                                    "type": "array",
                                    "description": "忌",
                                    "items": {
                                        "type": "string"
                                    },
                                    "example": [
                                        "动土",
                                        "破土",
                                        "安葬"
                                    ]
                                }
                            }
                        }
                    }
                }
            }
        },
        "出参示例": {
            "code": 200,
            "msg": "测算成功",
            "data": {
                "name": "王召阳",
                "gender": "male",
                "birth_date": "1999年11月15日 子时",
                "birth_place": "临沂市",
                "zeji_type": "wedding",
                "zeji_purpose": "选择结婚吉日，希望婚姻美满幸福",
                "date_range_start": "2026-05-01",
                "date_range_end": "2027-05-01",
                "advice": "红鸾星动，天喜临门。本月利于婚嫁，宜选双日，寓意成双成对。忌选父母生辰冲克之日。",
                "dates": [
                    {
                        "date": "2026-05-18",
                        "lunar": "四月十一",
                        "desc": "天德合日，官印相生",
                        "score": 98,
                        "hours": "巳时(09-11), 未时(13-15)",
                        "clash": "冲猪",
                        "suitable": [
                            "嫁娶",
                            "开市",
                            "出行",
                            "祈福",
                            "纳采"
                        ],
                        "avoid": [
                            "动土",
                            "破土",
                            "安葬"
                        ]
                    },
                    {
                        "date": "2026-05-22",
                        "lunar": "四月十五",
                        "desc": "月德合日，三合临旺",
                        "score": 95,
                        "hours": "辰时(07-09), 午时(11-13)",
                        "clash": "冲兔",
                        "suitable": [
                            "嫁娶",
                            "祭祀",
                            "祈福",
                            "求嗣"
                        ],
                        "avoid": [
                            "开市",
                            "动土",
                            "修造"
                        ]
                    }
                ]
            }
        }
    }
}