工作日和節假日api

xx19941215發表於2022-01-06

介紹
節假日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

引數
以下是您可以在請求中新增的所有引數。

引數型別示例值描述
tokenstringYOUR_API_TOKEN您的API token
start_datestring2020-12-12開始日期
daysint10天數
end_datestring2020-12-31結束日期

以下是響應中的所有引數。

引數型別示例值描述
codeint00表示請求成功
dayOffint10調班
holidayint10法定節假日
totalint30總計天數
weekdayint30工作日
weekendint30週末

錯誤
如果請求的HTTP狀態程式碼返回4xx 或者 5xx 此時返回的資料將會帶有一個msg欄位表示錯誤原因。
下面是當使用了錯誤token時返回的例子。

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

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

大家可以前往 https://calc.ygcf.info/docs 檢視詳細文件。
前往開發者中心https://calc.ygcf.info/reg 註冊賬號獲得TOKEN即可以開始使用。

相關文章