# 农历与二十四节气 API 数据接口


农历与二十四节气 API 数据接口

任意日期查询，农历日期返回，全年节气。

![gugudata_api_cover](https://static.gugudata.com/api_weather_lunar.jpg)

# 1. 产品功能

- 支持任意日期的农历与二十四节气查询；
- 节气包含当日、下一个以及全年节气与日期；
- 同时返回农历中文；
- 数据持续更新与维护；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡；
- [接口调用状态与状态监控](https://www.gugudata.com/status)

# 2. API 文档

**接口详情:** [https://www.gugudata.com/api/details/lunarcalendar](https://www.gugudata.com/api/details/lunarcalendar)

**接口地址:** https://api.gugudata.com/weather/lunarcalendar

**返回格式:** application/json; charset=utf-8

**请求方式:** GET

**请求协议:** HTTPS

**请求示例:** https://api.gugudata.com/weather/lunarcalendar?appkey=YOUR_APPKEY&date=YOUR_VALUE

**数据预览:** [https://www.gugudata.com/preview/lunarcalendar](https://www.gugudata.com/preview/lunarcalendar)

**接口测试:** [https://api.gugudata.com/weather/lunarcalendar/demo](https://api.gugudata.com/weather/lunarcalendar/demo)

# 3. 请求参数

| 参数名 | 参数类型 | 是否必须 |   默认值    |                     备注                      |
| :----: | :------: | :------: | :---------: | :-------------------------------------------: |
| appkey |  string  |    是    | YOUR_APPKEY |              付费后获取的 APPKEY              |
|  date  |  string  |    是    | YOUR_VALUE  | 请求转换的日期，格式为: yyyymmdd，如 20220101 |

# 4. 返回参数

|            参数名            | 参数类型 |                             备注                             |
| :--------------------------: | :------: | :----------------------------------------------------------: |
|    DataStatus.StatusCode     |   int    |                        接口返回状态码                        |
| DataStatus.StatusDescription |  string  |                       接口返回状态说明                       |
| DataStatus.ResponseDateTime  |  string  |                       接口数据返回时间                       |
|  DataStatus.DataTotalCount   |   int    |                      此条件下的总数据量                      |
|        Data.LunarDate        |  string  |                           农历日期                           |
|    Data.LunarDateChinese     |  string  |       农历中文日期，如: 二零二二 壬寅 虎年 九月小初三        |
|      Data.SolarTermNext      |  string  |               下一个节气与日期，如: 寒露:10-8                |
|    Data.SolarTermThisYear    |  string  | 本年所有节气与日期，如: 立春:2-4 雨水:2-19 惊蛰:3-5 春分:3-20 清明:4-5 谷雨:4-20 立夏:5-5 小满:5-21 芒种:6-6 夏至:6-21 小暑:7-7 大暑:7-23 立秋:8-7 处暑:8-23 白露:9-7 秋分:9-23 寒露:10-8 霜降:10-23 立冬:11-7 小雪:11-22 大雪:12-7 冬至:12-22 小寒:1-5 大寒:1-20 |
|     Data.SolarTermToday      |  string  |                   今日节气，如: 寒露:10-8                    |