随着互联网的发展,越来越多的应用需要根据日期来判断是否是法定节假日或者法定工作日。为了满足开发者的需求,我们提供了一个简单易用的API接口来解决这个问题。
接口及API接口功能
我们的接口是基于HTTP协议的GET请求,在指定的日期下返回该日期是否是国家法定节假日或者法定工作日的标识。
请求参数
参数名 | 参数说明 | 是否必须 | 示例值 |
---|---|---|---|
date | 查询的日期 | 是 | 2022-01-01 |
响应参数
参数名 | 参数说明 | 示例值 |
---|---|---|
data | 查询日期的工作日或节假日标识 | workday |
message | 标识查询结果的文本信息 | 工作日 |
code | 查询结果的状态码 | 200 |
errmsg | 查询结果的错误信息(如果有错误的话) |
返回示例
{
"data": "workday",
"message": "工作日",
"code": 200
}
返回结果说明
data | message | code | 含义 |
---|---|---|---|
workday | 工作日 | 200 | 是工作日 |
holiday | 节假日 | 200 | 是节假日 |
weekend | 周末 | 200 | 是周末 |
错误码表
code | errmsg | 含义 |
---|---|---|
400 | 参数错误 | 请求参数不正确 |
500 | 服务器内部错误 | 服务器发生了未知的错误 |
700 | 日期格式错误 | 日期格式不正确 |
701 | 日期超出范围 | 日期超过了查询范围 |
800 | 未找到查询相关的节假日信息 | 未找到相关的节假日信息 |
801 | 未找到查询相关的工作日信息 | 未找到相关的工作日信息 |
解决方案
我们的API接口是基于国家放假安排进行同步更新的,确保返回的数据准确可靠。在使用我们的接口时,需要注意以下几点:
- 日期格式必须为yyyy-mm-dd,否则将返回错误码700。
- 查询的日期范围应在合理范围内,否则将返回错误码701。
- 接口调用成功时,返回的数据会包含相关字段以及状态码200。
- 在查询失败时,会返回相应的错误码以及错误信息,方便开发者进行错误处理。
下面是一个使用示例:
import requests
def query_workday(date):
url = "https://www.wapi.cn/api/workday"
params = {"date": date}
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer xxxxxxxxxxxxxxxx"
}
response = requests.get(url, params=params, headers=headers)
if response.status_code == 200:
data = response.json()
if data["code"] == 200:
print(f"查询结果:{data['message']}")
else:
print(f"错误信息:{data['errmsg']}")
else:
print("请求失败")
if __name__ == "__main__":
date = "2022-01-01"
query_workday(date)
以上是一个使用Python编写的查询工作日的示例代码,通过调用我们提供的API接口来判断指定日期是否是工作日。开发者在实际使用时,只需将date
参数替换为需要查询的日期即可。
总结:通过使用我们提供的《法定工作日查询API接口》,开发者可以方便快速地根据指定日期判断是否是国家法定节假日或者法定工作日。我们的接口数据准确可靠,每年根据国家放假安排进行同步更新,为开发者提供全面的支持。欢迎开发者使用我们的接口,如果在使用过程中遇到问题,请随时联系我们的客服进行咨询。