传统历法宜忌参考

POST

https://api.gugudata.com/ai/traditional-calendar-guidance

国学与命理接口

按指定公历日期和时辰返回农历、干支、节气、宜忌、生肖冲煞和传统历法参考信息。

接口详情官网地址: https://www.gugudata.com/api/details/traditional-calendar-guidance
请求方法: POST
接口路径: /ai/traditional-calendar-guidance
调试地址: https://api.gugudata.com/ai/traditional-calendar-guidance/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

结果用于传统文化研究与娱乐参考，不作为现实决策依据。

请求参数

Query 参数

Body 参数application/json必填

示例

{
    "date": "2026-07-10",
    "time": "12:00",
    "timezone": "Asia/Shanghai",
    "language": "zh-CN"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff 'https://api.gugudata.com/ai/traditional-calendar-guidance?appkey=请前往 https://www.gugudata.com 购买&responseMode=sync&streaming=false' \
--header 'Content-Type: application/json' \
--data '{
    "date": "2026-07-10",
    "time": "12:00",
    "timezone": "Asia/Shanghai",
    "language": "zh-CN"
}'

返回响应

🟢200成功

application/json

接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。

Bodyapplication/json

示例

{
    "Data": {
        "基础数据": {
            "农历日期": {
                "property1": "string",
                "property2": "string"
            },
            "干支": {
                "property1": "string",
                "property2": "string"
            },
            "节气": {
                "property1": "string",
                "property2": "string"
            },
            "宜": [
                {}
            ],
            "忌": [
                {}
            ]
        },
        "文化解读": {
            "property1": "string",
            "property2": "string"
        }
    },
    "DataStatus": {
        "RequestParameter": "string",
        "StatusCode": 0,
        "StatusDescription": "string",
        "ResponseDateTime": "string",
        "DataTotalCount": 0
    }
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

修改于 2026-07-29 04:54:09

生肖周期趋势解读

星座周期趋势解读