658 lines
27 KiB
JSON
658 lines
27 KiB
JSON
{
|
||
"精准八字择吉接口规范": {
|
||
"接口名称": "精准八字择吉",
|
||
"接口路径": "/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": "顺应天时，趋吉避凶。所选吉日均为黄道瑞日，结合福主八字喜用神，可助事半功倍，平安顺遂。"
|
||
}
|
||
}
|
||
}
|
||
} |