介紹
節假日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即可以開始使用。