节假日接口

GET

/holiday/get

接口说明

节假日接口于2020年发布使用。您可以通过节假日接口获取从2007年至今的所有节假日信息。
次年的节假日信息与每年11月到12月更新。
接口坞提供的节假日接口功能非常强大，可以快速准确地获取各类节假日及调休信息，可以通过上方的调试按钮进行体验。

频次限制

匿名用户：5次/天
普通用户：60次/分钟
注：
匿名用户主要为请求中未携带任何身份标识的用户，主要以IP作为频次限制条件。
普通用户为通过API KEY或签名认证或登录TOKEN等所有有效身份标识的用户，以用户作为频次限制条件。

收费说明

匿名用户访问方式免费，后面有可能关闭，不推荐使用。
普通用户会在资源包中扣除用量，余量不足时暂停访问。购买资源包

请求参数

Authorization

在 query 添加参数

api_key

示例：

api_key: ********************

Query 参数

field

string

可选

用来指定返回结果包含的字段，多个使用英文逗号分隔，枚举项通过枚举接口获取

示例值:

holiday

year

integer

可选

用来指定要查询的年份，格式为 Y ,多个使用英文逗号分隔

示例值:

2023

month

integer

可选

用来指定要查询的月份，格式为 Ym ,多个使用英文逗号分隔，所有参数为空时默认查当月的数据

示例值:

202303

date

integer

可选

用来指定要查询的日期，格式为 Ymd ,多个使用英文逗号分隔

示例值:

20230303

yearweek

integer

可选

用来指定要查询一年中的第几周，格式为 oW ,多个使用英文逗号分隔

示例值:

202303

week

integer

可选

用来指定要查询的星期，多个使用英文逗号分隔，枚举项通过枚举接口获取

示例值:

workday

integer

可选

用来指定查询是否为工作日（包含调休在内需要上班的日子），枚举项通过枚举接口获取

示例值:

yearday

integer

可选

用来指定要查询一年中的第几天，格式为 z ,多个使用英文逗号分隔

示例值:

weekend

integer

可选

用来指定查询是否为周末（星期六和星期日），枚举项通过枚举接口获取

示例值:

holiday

integer

可选

用来指定要查询的节假日，多个使用英文逗号分隔，枚举项通过枚举接口获取

示例值:

holiday_overtime

integer

可选

用来指定要查询的节假日调休（加班），多个使用英文逗号分隔，枚举项通过枚举接口获取

示例值:

holiday_today

integer

可选

用来指定查询是否为节日当天，枚举项通过枚举接口获取

示例值:

holiday_legal

integer

可选

用来指定查询是否为法定节假日（三倍工资），枚举项通过枚举接口获取

示例值:

holiday_recess

integer

可选

用来指定查询是否为假期节假日（节日是否放假），枚举项通过枚举接口获取

示例值:

order_by

integer

是否按照日期倒序

可选

示例值:

lunar

integer

可选

用来指定年份、月份、日期、天数参数是否查询农历日期

示例值:

integer

可选

用来指定返回结果是否包含中文结果，默认返回的都是数字日期和枚举数字有利于逻辑判断不利于显示

示例值:

page

integer

分页页码

可选

示例值:

size

integer

分页每页数量

可选

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.apihubs.cn/holiday/get?field=holiday&year=2023&month=202303&date=20230303&yearweek=202303&week=1&workday=1&yearday=1&weekend=1&holiday=99&holiday_overtime=99&holiday_today=1&holiday_legal=1&holiday_recess=1&order_by=1&lunar=1&cn=1&page=1&size=31&api_key'

返回响应

🟢200成功

application/json

Body

code

integer

错误码

必需

0为成功，可以作为判断成功的依据，其他错误码可通过枚举接口获取

示例值:

msg

string

错误信息

必需

ok为成功，不能作为判断成功的依据，其他错误码可通过枚举接口获取

示例值:

data

object

响应数据

必需

page

integer

页码，从1开始

必需

示例值:

size

integer

每页数量

必需

示例值:

total

integer

总条数

必需

示例值:

100

list

array[object (节假日信息) {18}]

数据列表

必需

示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "page": 1,
    "size": 10,
    "total": 100,
    "list": [
      {
        "year": 2023,
        "month": 202303,
        "date": 20230303,
        "yearweek": 202303,
        "yearday": 1,
        "lunar_year": 2023,
        "lunar_month": 202303,
        "lunar_date": 20230303,
        "lunar_yearday": 1,
        "week": 1,
        "weekend": 2,
        "workday": 1,
        "holiday": 22,
        "holiday_or": 22,
        "holiday_overtime": 10,
        "holiday_today": 1,
        "holiday_legal": 1,
        "holiday_recess": 1
      }
    ]
  }
}

修改于 2023-05-11 01:21:22

枚举接口

节假日获取工作日下一天接口

节假日接口

接口说明#

频次限制#

收费说明#

请求参数

示例代码

返回响应

接口说明

频次限制

收费说明