传统历法宜忌参考（SSE）

按指定日期查询传统历法资料，覆盖 1901 至 2100 年，适合日历与传统文化知识产品。

同时提供公历、农历及干支日期，便于在同一张日历卡片中展示不同历法的信息。

提供节气日期与时间资料，可用于节气内容页、传统文化栏目和年度日历资料整理。

返回传统宜忌事项及对应文化解释，便于将历法记录与阅读说明分区呈现。

提供冲煞及方位等传统历法内容，适合传统历书资料查询与文化概念介绍。

包含值日与黄黑道等文化属性，便于在历法知识页面中展示具体条目并附上解释。

提供二十八宿名称及文化属性，可用于传统天文历法主题的知识阅读与资料展示。

可输入查询时间以获取对应时辰及干支资料，便于在日期查询基础上补充时段内容。

提供适合安排、建议避开与时段提醒等文化解读，方便组织分段清晰的日期参考页面。

支持简体中文、繁体中文与英文说明，可用于不同语言的传统日历与节气内容应用。

相关解读仅供娱乐、传统文化研究与参考，不代表经科学验证的预测，不应作为医疗、法律、投资、婚姻或职业等重要现实决策的唯一依据。

当前接口契约

接口详情：https://www.gugudata.com/api/details/traditional-calendar-guidance

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	开发者中心获取的 APPKEY，支持 Query、AppKey、X-GUGUDATA-APPKEY、X-API-Key、Bearer 或 JSON body。 AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。
date	string	是	无	需要查询的公历日期，严格使用 YYYY-MM-DD 格式，范围 1901-01-01 至 2100-12-31。
time	string	否	无	需要查询的具体时间，使用 HH:mm 或 HH:mm:ss 的 24 小时制格式；不传时按中午 12:00 计算。
timezone	string	否	Asia/Shanghai	日期与时辰使用的时区，当前固定支持 Asia/Shanghai。
language	string	否	zh-CN	输出语言，支持 zh-CN、zh-TW、en-US。
responseMode	string	否	sync	响应模式：sync 同步返回结果；task 创建异步任务并返回 operationId。
streaming	boolean	否	false	是否使用 SSE 流式响应。true 仅支持 responseMode=sync，不能与 task 同时使用。

正常响应字段

字段	类型	说明
Data.基础数据.输入信息	object	规范化日期、时间、时区和输出语言。
Data.基础数据.计算规则	object	默认时间、民用日界、时辰规则和规则版本。
Data.基础数据.农历日期	object	农历年月日和中文日期。
Data.基础数据.干支	object	年、月、日、时干支。
Data.基础数据.节气	object	当日节气及下一节气的日期和精确时间。
Data.基础数据.查询时辰	object	输入时间对应的时辰名称、范围和干支。
Data.基础数据.冲煞	object	冲生肖、冲干支和煞方。
Data.基础数据.宜	array	传统历法宜项。
Data.基础数据.忌	array	传统历法忌项。
Data.基础数据.值日信息	object	建除十二神、值神、黄黑道和吉凶。
Data.基础数据.二十八宿信息	object	宿名、动物和吉凶。
Data.文化解读	object	固定结构的日期摘要、安排建议、时段提醒和文化说明。
Data.免责声明	string	文化研究与娱乐参考边界。
Data.operationId	string	任务模式返回的任务标识。
Data.pollingUrl	string	任务状态查询地址。
Data.result	object	任务成功时返回的完整业务结果。
SSE.done.result	object	流式完成事件中的完整已校验结果。

业务状态说明

业务状态码	业务状态码解释	备注
100	请求成功	HTTP 200。
501	参数错误	HTTP 400；日期、时间、时区、语言或响应模式无效。
502	请求频率受限	HTTP 429。
503	订单已到期	HTTP 403。
504	APPKEY 错误	HTTP 401；包含缺少 APPKEY。
505	调用额度耗尽	HTTP 403。
900	内部错误	HTTP 500。
901	内容服务不可用	HTTP 503

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

请求成功（业务码 100）。

Bodyapplication/json

示例

{
    "DataStatus": {
        "ResponseDateTime": "string",
        "DataTotalCount": 0,
        "RequestParameter": "string",
        "StatusDescription": "string",
        "StatusCode": 0
    },
    "Data": {
        "基础数据": {
            "输入信息": {
                "日期": "2019-08-24",
                "时间": "14:15:22.123Z",
                "时区": "Asia/Shanghai",
                "输出语言": "zh-CN"
            },
            "计算规则": {
                "默认时间": "string",
                "日界规则": "string",
                "时辰规则": "string",
                "规则版本": "string"
            },
            "公历时间": "string",
            "农历日期": {
                "年": 0,
                "月": 0,
                "日": 0,
                "是否闰月": true,
                "中文": "string"
            },
            "干支": {
                "年柱": "string",
                "月柱": "string",
                "日柱": "string",
                "时柱": "string"
            },
            "生肖": "string",
            "星座": "string",
            "节气": {
                "当日": "string",
                "下一个": "string",
                "日期": "2019-08-24",
                "日期时间": "string"
            },
            "星期": "string",
            "季节": "string",
            "星次": "string",
            "查询时辰": {
                "名称": "string",
                "时间范围": "string",
                "干支": "string"
            },
            "生肖冲煞": "string",
            "冲煞": {
                "冲生肖": "string",
                "冲干支": "string",
                "煞方": "string"
            },
            "宜": [
                "string"
            ],
            "忌": [
                "string"
            ],
            "吉神": [
                "string"
            ],
            "凶煞": [
                "string"
            ],
            "彭祖百忌": "string",
            "十二值日": [
                "string"
            ],
            "值日信息": {
                "建除十二神": "string",
                "值神": "string",
                "黄黑道": "string",
                "吉凶": "string"
            },
            "二十八宿": "string",
            "二十八宿信息": {
                "宿名": "string",
                "动物": "string",
                "吉凶": "string"
            },
            "纳音": "string",
            "吉神方位": [
                "string"
            ],
            "胎神": "string"
        },
        "文化解读": {
            "日期摘要": "string",
            "适合安排": [
                "string"
            ],
            "建议避开": [
                "string"
            ],
            "时段提醒": {
                "上午": "string",
                "下午": "string",
                "晚间": "string"
            },
            "文化说明": "string"
        },
        "免责声明": "string"
    }
}

🟠400参数错误（业务码 501）。

🟠401APPKEY 错误（业务码 504）。

🟠403订单已到期（业务码 503）；调用额度耗尽（业务码 505）。

🟠404资源不存在。请求路径不存在。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

🟠429请求频率受限（业务码 502）。

🔴500内部错误（业务码 900）。

🔴502数据服务暂时不可用，请稍后重试。

🔴503内容服务不可用（业务码 901）。

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明