之前写过一个工作日在线计算的小工具,许多网友反馈也想用 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 不正确"
}
大家可以前往 https://calc.ygcf.info/docs 查看详细文档。 前往开发者中心https://calc.ygcf.info/reg 注册账号获得 TOKEN 即可以开始使用。
1
gaozizhong 2022-01-29 15:41:12 +08:00
很好用,不错,之前自己也想开放几个自己做接口,能说一下接口计数啥的问题都是用什么技术做的吗?
|
2
shisico 2022-01-29 15:46:09 +08:00
点赞点赞
|
3
xx19941215 OP @gaozizhong 就是在请求进来和结束的时候记录一下各个参数然后存入数据库就行了,目前是这样简单处理的。
|
4
hideon 2022-01-29 16:50:10 +08:00
我目前也在做相同的事情,由于组内人员认为所有公开的接口都存在不确定性,所以只能自己开发了。不过也挺简单的,就是简单的入库和查询,然后每天爬一次 http://sousuo.gov.cn/s.htm?q=%E8%8A%82%E5%81%87%E6%97%A5&t=paper 看有没有最新的,如果有就通知人工更新数据库。
|
5
xx19941215 OP @uoolee11 哈哈 有的小团队有时候项目工期紧还是需要这么一个服务的
|
6
xx19941215 OP @uoolee11 小工具 19 年上线,稳定运行 2 年多了,我的小目标是先稳定在线到 2029 年哈哈,然后一直维护到我退休。
|
7
skys215 2022-01-30 12:55:30 +08:00
|