工作日計算api

蕭瀟發表於2022-01-06
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 協議》，轉載必須註明作者和本文連結

相關文章