法定工作日查询API接口

360 阅读3分钟

image.png

随着互联网的发展,越来越多的应用需要根据日期来判断是否是法定节假日或者法定工作日。为了满足开发者的需求,我们提供了一个简单易用的API接口来解决这个问题。

接口及API接口功能

我们的接口是基于HTTP协议的GET请求,在指定的日期下返回该日期是否是国家法定节假日或者法定工作日的标识。

接口地址:www.wapi.cn/api/workday

请求参数

参数名参数说明是否必须示例值
date查询的日期2022-01-01

响应参数

参数名参数说明示例值
data查询日期的工作日或节假日标识workday
message标识查询结果的文本信息工作日
code查询结果的状态码200
errmsg查询结果的错误信息(如果有错误的话)

返回示例

{
    "data": "workday",
    "message": "工作日",
    "code": 200
}

返回结果说明

datamessagecode含义
workday工作日200是工作日
holiday节假日200是节假日
weekend周末200是周末

错误码表

codeerrmsg含义
400参数错误请求参数不正确
500服务器内部错误服务器发生了未知的错误
700日期格式错误日期格式不正确
701日期超出范围日期超过了查询范围
800未找到查询相关的节假日信息未找到相关的节假日信息
801未找到查询相关的工作日信息未找到相关的工作日信息

解决方案

我们的API接口是基于国家放假安排进行同步更新的,确保返回的数据准确可靠。在使用我们的接口时,需要注意以下几点:

  1. 日期格式必须为yyyy-mm-dd,否则将返回错误码700。
  2. 查询的日期范围应在合理范围内,否则将返回错误码701。
  3. 接口调用成功时,返回的数据会包含相关字段以及状态码200。
  4. 在查询失败时,会返回相应的错误码以及错误信息,方便开发者进行错误处理。

下面是一个使用示例:

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接口》,开发者可以方便快速地根据指定日期判断是否是国家法定节假日或者法定工作日。我们的接口数据准确可靠,每年根据国家放假安排进行同步更新,为开发者提供全面的支持。欢迎开发者使用我们的接口,如果在使用过程中遇到问题,请随时联系我们的客服进行咨询。