工作日计算api

介绍

之前写过一个工作日在线计算的小工具,许多网友反馈也想用api,这里花了点时间将API开放出来。

起步

如果您需要知道某个日期N个工作日之后是什么日子,您可以使用 GET 或者 POST 向下面的入口发起一个请求。

https://calc.ygcf.info/api/v1/workday/end

如果您需要知道某两个日期之前的工作日分布情况,您可以使用 GET 或者 POST 向下面的入口发起一个请求。

https://calc.ygcf.info/api/v1/workday/count

例子

如果需要获取2020-12-12 10个工作日之后是什么日子。

https://calc.ygcf.info/api/v1/workday/end?start_date=2020-12-12&days=10

如果需要获取2020-12-12 到2020-12-31 之前的工作日分布情况。

https://calc.ygcf.info/api/v1/workday/count?start_date=2020-12-12&end_date=2020-12-31

认证

注册之后可以在个人中心获取token,添加 token 参数在您的API请求中以获得认证。

https://calc.ygcf.info/api/v1/workday/end?
            start_date=2020-12-12&days=10
            &token=YOUR_API_TOKEN

参数

以下是您可以在请求中添加的所有参数。

参数 类型 示例值 描述
token string YOUR_API_TOKEN 您的API token
start_date string 2020-12-12 开始日期
days int 10 天数
end_date string 2020-12-31 结束日期

以下是响应中的所有参数。

参数 类型 示例值 描述
code int 0 0表示请求成功
dayOff int 10 调班
holiday int 10 法定节假日
total int 30 总计天数
weekday int 30 工作日
weekend int 30 周末

错误

如果请求的HTTP状态代码返回4xx 或者 5xx 此时返回的数据将会带有一个msg字段表示错误原因。
下面是当使用了错误token时返回的例子。

{
   "code": 422,
   "data": [

   ],
   "msg": "token不正确"
}

大家可以前往 calc.ygcf.info/docs 查看详细文档。
前往开发者中心calc.ygcf.info/reg 注册账号获得TOKEN即可以开始使用。

本作品采用《CC 协议》,转载必须注明作者和本文链接
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
讨论数量: 7

大佬辛苦了。 :+1:

请问能批量查出最近一年的所有节假日(含调休)对应的日期吗? :smile:

2年前 评论
小李世界 2年前
萧潇 (楼主) 2年前
liziyu (作者) 2年前

file

file

这个是扣去了两天调休?

2年前 评论
萧潇 (楼主) 2年前
小李世界 (作者) 2年前

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!