{ "精准八字择吉接口规范": { "接口名称": "精准八字择吉", "接口路径": "/api/auspicious/calculate", "请求方法": "POST", "入参 (Request)": { "eventType": { "type": "string", "required": true, "description": "求测事项类型", "enum": [ "kaichang", "jiehun", "qiaoqian", "dongtu", "qiuzi", "other" ], "enum_labels": { "kaichang": "开业开市", "jiehun": "嫁娶结婚", "qiaoqian": "乔迁入宅", "dongtu": "动土修造", "qiuzi": "求嗣祈福", "other": "手动填写" } }, "customEvent": { "type": "string", "required": false, "description": "自定义事项（当eventType为other时必填）", "example": "签约" }, "name": { "type": "string", "required": true, "description": "福主姓名", "example": "张三" }, "gender": { "type": "string", "required": true, "description": "性别", "enum": [ "male", "female" ], "enum_labels": { "male": "男", "female": "女" } }, "birthDateDisplay": { "type": "string", "required": true, "description": "出生日期时辰（显示格式）", "example": "1990年1月1日 子时" }, "birthDateApi": { "type": "string", "required": true, "description": "出生日期时辰（API格式）", "format": "YYYY-MM-DD HH:mm:ss", "example": "1990-01-01 00:30:00" } }, "入参示例": { "eventType": "jiehun", "customEvent": "", "name": "张三", "gender": "male", "birthDateDisplay": "1990年1月1日 子时", "birthDateApi": "1990-01-01 00:30:00" }, "出参 (Response)": { "code": { "type": "number", "description": "状态码，200表示成功" }, "msg": { "type": "string", "description": "返回消息" }, "data": { "type": "object", "description": "择吉结果数据", "properties": { "report_id": { "type": "number", "description": "报告ID（用于支付解锁）", "example": 12345 }, "business_id": { "type": "number", "description": "业务ID（同report_id）", "example": 12345 }, "business_type": { "type": "string", "description": "业务类型", "example": "auspicious_report" }, "eventType": { "type": "string", "description": "事项类型", "example": "jiehun" }, "eventLabel": { "type": "string", "description": "事项标签", "example": "嫁娶结婚" }, "customEvent": { "type": "string", "description": "自定义事项", "example": "" }, "name": { "type": "string", "description": "福主姓名", "example": "张三" }, "gender": { "type": "string", "description": "性别", "example": "male" }, "birthDate": { "type": "string", "description": "出生日期时辰（显示格式）", "example": "1990年1月1日 子时" }, "birthDateApi": { "type": "string", "description": "出生日期时辰（API格式）", "example": "1990-01-01 00:30:00" }, "advice": { "type": "string", "description": "择吉分析建议", "example": "红鸾星动，天喜临门。本月利于婚嫁，宜选双日，寓意成双成对。忌选父母生辰冲克之日。" }, "dates": { "type": "array", "description": "吉日列表", "items": { "type": "object", "properties": { "date": { "type": "string", "description": "公历日期", "format": "YYYY-MM-DD", "example": "2024-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": [ "动土", "破土", "安葬" ] }, "ganZhi": { "type": "object", "description": "干支信息", "properties": { "year": { "type": "string", "description": "年干支", "example": "甲辰" }, "month": { "type": "string", "description": "月干支", "example": "己巳" }, "day": { "type": "string", "description": "日干支", "example": "庚午" } } }, "wuxing": { "type": "object", "description": "五行信息", "properties": { "day": { "type": "string", "description": "日五行", "example": "金" }, "nayin": { "type": "string", "description": "纳音", "example": "路旁土" } } }, "stars": { "type": "array", "description": "吉星", "items": { "type": "string" }, "example": [ "天德", "月德", "三合" ] }, "gods": { "type": "object", "description": "神煞", "properties": { "good": { "type": "array", "description": "吉神", "items": { "type": "string" }, "example": [ "天德合", "月德合", "天喜" ] }, "bad": { "type": "array", "description": "凶神", "items": { "type": "string" }, "example": [ "五鬼", "血支" ] } } } } } }, "unlockInfo": { "type": "object", "description": "解锁信息", "properties": { "freeCount": { "type": "number", "description": "免费查看数量", "example": 2 }, "basicCount": { "type": "number", "description": "基础版解锁数量（近期吉日）", "example": 5 }, "premiumCount": { "type": "number", "description": "尊享版解锁数量（全年吉日）", "example": 30 }, "basicPrice": { "type": "number", "description": "基础版价格（元）", "example": 9.9 }, "premiumPrice": { "type": "number", "description": "尊享版价格（元）", "example": 38 }, "premiumOriginalPrice": { "type": "number", "description": "尊享版原价（元）", "example": 99.9 } } }, "statistics": { "type": "object", "description": "统计信息", "properties": { "totalUsers": { "type": "number", "description": "已测算人数", "example": 28392 } } } } } }, "出参示例": { "code": 200, "msg": "测算成功", "data": { "report_id": 12345, "business_id": 12345, "business_type": "auspicious_report", "eventType": "jiehun", "eventLabel": "嫁娶结婚", "customEvent": "", "name": "张三", "gender": "male", "birthDate": "1990年1月1日 子时", "birthDateApi": "1990-01-01 00:30:00", "advice": "红鸾星动，天喜临门。本月利于婚嫁，宜选双日，寓意成双成对。忌选父母生辰冲克之日。", "dates": [ { "date": "2024-05-18", "lunar": "四月十一", "desc": "天德合日，官印相生", "score": 98, "hours": "巳时(09-11), 未时(13-15)", "clash": "冲猪", "suitable": [ "嫁娶", "开市", "出行", "祈福", "纳采", "订盟" ], "avoid": [ "动土", "破土", "安葬", "修坟" ], "ganZhi": { "year": "甲辰", "month": "己巳", "day": "庚午" }, "wuxing": { "day": "金", "nayin": "路旁土" }, "stars": [ "天德", "月德", "三合", "天喜" ], "gods": { "good": [ "天德合", "月德合", "天喜", "天医", "福星" ], "bad": [ "五鬼", "血支" ] } }, { "date": "2024-05-22", "lunar": "四月十五", "desc": "月德合日，三合临旺", "score": 95, "hours": "辰时(07-09), 午时(11-13)", "clash": "冲兔", "suitable": [ "嫁娶", "祈福", "纳采", "开市", "立券" ], "avoid": [ "动土", "破土", "安葬" ], "ganZhi": { "year": "甲辰", "month": "己巳", "day": "甲戌" }, "wuxing": { "day": "木", "nayin": "山头火" }, "stars": [ "月德", "三合", "天喜" ], "gods": { "good": [ "月德合", "三合", "天喜", "天贵" ], "bad": [ "天刑", "朱雀" ] } }, { "date": "2024-06-05", "lunar": "四月廿九", "desc": "天赦日，百无禁忌", "score": 92, "hours": "卯时(05-07), 酉时(17-19)", "clash": "冲蛇", "suitable": [ "嫁娶", "祈福", "开市", "出行", "纳采", "订盟", "安床" ], "avoid": [ "安葬", "修坟" ], "ganZhi": { "year": "甲辰", "month": "庚午", "day": "戊子" }, "wuxing": { "day": "土", "nayin": "霹雳火" }, "stars": [ "天赦", "天德", "福星" ], "gods": { "good": [ "天赦", "天德", "福星", "天贵", "天医" ], "bad": [ "劫煞" ] } }, { "date": "2024-06-18", "lunar": "五月十三", "desc": "黄道吉日，诸事皆宜", "score": 88, "hours": "巳时(09-11), 申时(15-17)", "clash": "冲鼠", "suitable": [ "嫁娶", "开市", "出行", "祈福", "纳采" ], "avoid": [ "动土", "破土" ], "ganZhi": { "year": "甲辰", "month": "庚午", "day": "辛丑" }, "wuxing": { "day": "金", "nayin": "壁上土" }, "stars": [ "黄道", "天德" ], "gods": { "good": [ "黄道", "天德", "天喜" ], "bad": [ "白虎" ] } }, { "date": "2024-07-02", "lunar": "五月廿七", "desc": "六合吉日，贵人得位", "score": 90, "hours": "辰时(07-09), 未时(13-15)", "clash": "冲虎", "suitable": [ "嫁娶", "祈福", "开市", "纳采", "订盟" ], "avoid": [ "动土", "安葬" ], "ganZhi": { "year": "甲辰", "month": "庚午", "day": "乙卯" }, "wuxing": { "day": "木", "nayin": "大溪水" }, "stars": [ "六合", "天贵" ], "gods": { "good": [ "六合", "天贵", "天喜", "福星" ], "bad": [ "天刑" ] } } ], "unlockInfo": { "freeCount": 2, "basicCount": 5, "premiumCount": 30, "basicPrice": 9.9, "premiumPrice": 38, "premiumOriginalPrice": 99.9 }, "statistics": { "totalUsers": 28392 } } }, "解锁等级说明": { "none": { "description": "未解锁", "viewCount": 2, "features": [ "查看前2个吉日的基本信息", "吉时和冲煞信息被锁定" ] }, "basic": { "description": "基础版（近期吉日）", "price": 9.9, "viewCount": 5, "features": [ "查看未来30天精选吉日", "完整吉时信息", "冲煞详情", "宜忌事项" ] }, "premium": { "description": "尊享版（全年吉日）", "price": 38, "originalPrice": 99.9, "viewCount": 30, "features": [ "查看1年内所有吉日", "完整吉时信息", "冲煞详情", "宜忌事项", "干支五行", "吉星神煞", "生成分享海报" ] } }, "事项类型建议映射": { "kaichang": { "label": "开业开市", "advice": "财星高照，禄马同乡。宜选水日或金日开市，取金水相生之意。店铺朝向宜避开五黄煞位。" }, "jiehun": { "label": "嫁娶结婚", "advice": "红鸾星动，天喜临门。本月利于婚嫁，宜选双日，寓意成双成对。忌选父母生辰冲克之日。" }, "qiaoqian": { "label": "乔迁入宅", "advice": "安床纳财，移徙大吉。入宅时宜手持贵重物品，忌空手入屋。当日宜开火煮汤圆，寓意团圆美满。" }, "dongtu": { "label": "动土修造", "advice": "择吉动土，百事顺遂。宜选土旺之日，避开岁破、月破之时。动土前宜祭拜土地神，以求平安。" }, "qiuzi": { "label": "求嗣祈福", "advice": "天喜临门，子孙昌盛。宜选月德、天德之日祈福，诚心祷告，必得神佑。" }, "other": { "label": "祈福择吉", "advice": "顺应天时，趋吉避凶。所选吉日均为黄道瑞日，结合福主八字喜用神，可助事半功倍，平安顺遂。" } } } }