284 lines
11 KiB
JSON
284 lines
11 KiB
JSON
{
|
||
"八字择吉接口规范": {
|
||
"接口名称": "八字择吉测算",
|
||
"接口路径": "/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": [
|
||
"开市",
|
||
"动土",
|
||
"修造"
|
||
]
|
||
}
|
||
]
|
||
}
|
||
}
|
||
}
|
||
} |