介绍
工作日计算器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不正确"
}