加班費計算機API¶
使用 Google App Script,以Web API的方式提供一例一休新制加班費計算功能。本版API使用與手機版加班費計算機相同的Javascript Library。(版本:20161229)
API網址:¶
https://script.google.com/macros/s/AKfycbwmt2Z4GLwNsEncFJRC0vcl9WMF2yAmlUlzeh_IFvNOkGavXT7C/exec
輸入參數:¶
參數名稱 |
預設值 |
說明 |
|---|---|---|
salary |
36000 |
月薪 |
type |
1 |
1 工作日 2 休息日 3 例假日 4 特休 5 國定假日 |
clock_in |
08:00 |
上班時間(打卡時間);格式: hh:mm |
clock_out |
18:00 |
下班時間(打卡時間);格式: hh:mm |
break_duration |
60 |
中間休息時間(分鐘) |
ot_unit |
60 |
加班計算單位(分鐘) |
ot_min |
30 |
超過多少分鐘便可算一個加班單位(分鐘)。例如預設是60/30的話,則 1小時35分,可算兩個小時。 |
所有參數都是選擇性的,缺乏的參數使用預設值。
JSON輸出:¶
Key |
Value Type |
說明 |
|---|---|---|
version |
string |
API版本 |
warning |
[string] |
警告事項,目前只有一個。若加班時間超過四小時,顯示警告。 |
daily_pay |
{ value:(float), title:”時薪” } |
月薪/240 |
type_name |
{ value:(float), title:”性質” } |
工作日、休息日、例假日、休假日四種之一 |
work_hours |
{ value:(float), title:”實際工時” } |
下班時間-上班時間-休息時間 |
work_hours_law |
{ value:(float), title:”法定工時” } |
休息日以四小時為加班單位、休假日與例假日至少八小時。 |
extra_pay_1to8 |
{ value:(float), title:”前八小時額外工資” } |
當日工作前八小時的額外給付工資 |
extra_pay_9to12 |
{ value:(float), title:”後四小時加班工資” } |
當日工作第九到十二小時的額外給付工資 |
extra_pay_1to12 |
{ value:(float), title:”當日額外工資” } |
當日工作額外給付工資的總額(口語上的「加班費」) |
total_pay |
{ value:(float), title:”當日總工資” } |
當日底薪+額外給付工資總額 |
測試:¶
# dump to stdout
$ wget -qO- "https://script.google.com/macros/s/AKfycbwmt2Z4GLwNsEncFJRC0vcl9WMF2yAmlUlzeh_IFvNOkGavXT7C/exec" 2>/dev/null
# dump to stdout
$ curl -Lvs "https://script.google.com/macros/s/AKfycbwmt2Z4GLwNsEncFJRC0vcl9WMF2yAmlUlzeh_IFvNOkGavXT7C/exec" 2>/dev/null
範例:¶
範例 |
參數內容 |
?type=1&clock_in=9:00&clock_out=19:00 |
|
?type=2&clock_in=09:00&clock_out=19:00&salary=22000 |
|
?type=3&clock_in=09:00&clock_out=22:00&salary=22000 |
|
?type=4&clock_in=08:00&clock_out=22:00&salary=22000&break_duration=120 |
|
?type=5&clock_in=09:00&clock_out=22:00&salary=22000&ot_unit=30&ot_min=15 |