农历查询API接口说明

Question

如题所述

Answer 1

1. 百度提供的农历计算服务准确度较高，包括黄历和禁忌的计算。相比之下，其他网站的计算准确性往往不足，尤其在闰月和年份开头或结尾时容易出现错误。
2. 目前市面上的农历计算大多采用JavaScript实现，Java版本的计算器则鲜见且多数存在问题。经过对比和分析，我决定将一个JavaScript的农历计算器翻译成Java版本，从而推出了这个API接口。
3. 我们通过微服务架构提供这个API，保证了高响应效率且不限制调用次数。重要的是，这项服务完全免费，并且支持JSON格式的数据返回。
4. 该接口返回的数据内容全面，包含了农历、黄历、禁忌、星期、生肖、当月节气、是否闰月以及月份大小等信息。
5. 参数要求采用 "yyyy-MM-dd" 的格式，如果不传入参数，则默认为查询当天。用户通过GET请求即可获取数据。
6. 以下是农历查询的演示。如果不传入参数，API会返回当天的农历信息。请求链接为：http://www.sojson.com/open/api/lunar/json.shtml。成功状态码为200，失败则为500。
7. 农历查询的JSON返回格式（成功情况）：
[
{
"lunar": "农历日期",
"holiday": "节假日名称",
"week": "星期几",
"animal": "生肖",
"solarTerm": "当月节气",
"leapMonth": "是否闰月",
"isBigMonth": "是否大月"
}
]
8. 农历查询的JSON返回格式（失败情况）：
[
{
"error": "错误信息"
}
]
9. 若请求失败，通常是因为参数问题，如参数格式不正确或不符合规则。正确的参数格式为 "yyyy-MM-dd"，例如 "2017-02-02"。
10. 用户也可以指定日期进行查询。例如，请求链接为：http://www.sojson.com/open/api/lunar/json.shtml?date=2017-05-27。参数可以写作 "2017-05-27" 或者 "2017-5-27"。
11. 成功请求的结果应符合上述的成功JSON返回格式。如有错误信息，可参考上述的失败JSON返回格式。
12. 点击此处查看原网页以获取更多信息：[原网页链接]。