刷卡資料介接
用於接收由門禁、打卡鐘等外部系統傳來的打卡資料，包括：打卡資料寫入。
salary_item = {
"CO_ID": number, //公司_ID
"CLOCK_FORMAT_ID": number, //刷卡鐘代號_ID
"FORMAT_NAME": string, //格式名稱
"FORMAT_TYPE": string, //資料接收格式 1:純文字檔(.txt,.csv,.dat) 2:Office Excel(.xls,.xlsx)
},Authorizations
Responses
200
成功
```
{
code: 200,
data: [clock, clock, ...],
}
```
401
認證失敗 (請更新 accessToken 再試一次)
403
權限不足
440
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
490
失敗
```
{
code: 490,
msg: string, // 失敗原因
}
```
499
DB錯誤 `{ code: 499, msg: string }`
500
系統異常 `{ code: 500, msg: string }`
post
POST /api/am/clock/format HTTP/1.1
Host:
Authorization: Bearer JWT
Accept: */*
No content
code, //回傳訊息代號
msg: string, //回傳訊息Authorizations
Body
CO_IDintegerRequired
公司ID
EMP_IDintegerRequired
員工ID
CARD_DATETIMEstring | dateRequired
打卡時間
CARD_TYPEintegerRequired
打卡別
TEMP_UNITstringRequired
體溫單位
TEMP_VALUEdoubleRequired
體溫值
Responses
200
成功
```
{
code: 200
}
```
401
認證失敗 (請更新 accessToken 再試一次)
403
權限不足
440
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
490
失敗
```
{
code: 490,
msg: string, // 失敗原因
}
```
491
失敗
```
{
code: 491,
msg: 打卡時間重複
}
```
499
DB錯誤 `{ code: 499, msg: string }`
500
系統異常 `{ code: 500, msg: string }`
post
POST /api/am/clock/insert HTTP/1.1
Host:
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 111
{
"CO_ID": 1,
"EMP_ID": 31886,
"CARD_DATETIME": "2022-08-24 08:00",
"CARD_TYPE": 1,
"TEMP_UNIT": "C",
"TEMP_VALUE": "26.5"
}No content
回傳格式：
// responses
{
"code": number
"data": {
"success": number, //成功筆數
"fail": number, //失敗筆數
"errorData": [row, row...] //失敗資料
}
}
// 解析資料結果範例 錯誤為object
row = {
"rowIndex": number, //資料行數
"year": 2023, //年
"month": 8, //月
"day": 2, //日
"hour": 8, //時
"min": 8, //分
"sec": 0, //秒
"date": "2023/08/02", //日期
"time": "08:08:00", //時間
"clock": "002", //卡鐘
"empNo": { //員工編號
"key": "empNo",
"value": "D001",
"invalid": "無此員工編號"
},
}
// 錯誤 object
err = {
"key": string, //錯誤項目
"value": string, //取得值
"invalid": string //錯誤訊息
}Authorizations
Body
CO_IDintegerRequired
公司ID
CLOCK_FORMAT_IDintegerRequired
刷卡鐘代號_ID
attachmentstring · binaryRequired
multipart request 的 field name 必須是 'attachment'
Responses
200
成功
401
認證失敗 (請更新 accessToken 再試一次)
403
權限不足
440
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
450
MulterError `{ code: 450, msg?: string }`
500
系統異常 `{ code: 500, msg: string }`
post
POST /api/am/clock/import HTTP/1.1
Host:
Authorization: Bearer JWT
Content-Type: multipart/form-data
Accept: */*
Content-Length: 53
{
"CO_ID": 1,
"CLOCK_FORMAT_ID": 1,
"attachment": "binary"
}No content