刷卡資料介接

打卡資料寫入

post

用於接收由門禁、打卡鐘等外部系統傳來的打卡資料

Required scopes

This endpoint requires the following scopes:

• : 提供操作 104 企業大師-人資管理 API 權限

Authorizations

oauth2_auth

OAuth2applicationRequired

Token URL:

Header parameters

authorizationanyRequired

access token

Bodyobject[]

application/json

empNostringOptional

員編

Example: A0001

cardTimeinteger · int64Optional

打卡時間timestamp

Example: 1566349095938

Responses

200

success

application/json

successintegerOptionalExample: 30

ignoreintegerOptionalExample: 5

failintegerOptionalExample: 2

400

商務邏輯相關錯誤(code對應訊息，同sample順序)

application/json

401

權限不足相關錯誤(code對應訊息，同sample順序)

application/json

post/hrmapi/external/transferCard

HTTPcURLJavaScriptPython

POST //apis.104api.com.tw/prohrm/1.0/hrmapi/external/transferCard HTTP/1.1
Host: https:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44

[
  {
    "empNo": "A0001",
    "cardTime": 1566349095938
  }
]

{
  "success": 30,
  "ignore": 5,
  "ignoreDetail": [
    {
      "idx": 1,
      "errorMsg": "員工編號空白"
    }
  ],
  "fail": 2,
  "failDetail": [
    {
      "idx": 2,
      "errorMsg": "員工編號不存在"
    }
  ]
}

第三方卡鐘資料傳輸

post

用於接收由門禁、打卡鐘等外部系統傳來的打卡資料

Required scopes

This endpoint requires the following scopes:

• : 提供操作 104 企業大師-人資管理 API 權限

Authorizations

oauth2_auth

OAuth2applicationRequired

Token URL:

Header parameters

authorizationanyRequired

access token

Bodyobject[]

application/json

unostringOptional

統編

Example: 123456789

Responses

200

success

application/json

unostringOptional

統編

Example: 123456789

codeintegerOptional

結果代碼

Example: 200,490,491,492,493

msgstringOptional

資料相關錯誤(code對應訊息，同sample順序)

Example: 正常,公司已關閉或超過時間未繳費,該公司未同意使用,無資料,未預期錯誤

successintegerOptionalExample: 30

ignoreintegerOptionalExample: 5

failintegerOptionalExample: 2

400

商務邏輯相關錯誤(code對應訊息，同sample順序)

application/json

401

權限不足相關錯誤(code對應訊息，同sample順序)

application/json

post/hrmapi/external/transferTpCard

HTTPcURLJavaScriptPython

POST //apis.104api.com.tw/prohrm/1.0/hrmapi/external/transferTpCard HTTP/1.1
Host: https:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 75

[
  {
    "uno": 123456789,
    "cardData": [
      {
        "empNo": "A0001",
        "cardTime": 1566349095938
      }
    ]
  }
]

[
  {
    "uno": 123456789,
    "code": "200,490,491,492,493",
    "msg": "正常,公司已關閉或超過時間未繳費,該公司未同意使用,無資料,未預期錯誤",
    "success": 30,
    "ignore": 5,
    "ignoreDetail": [
      {
        "idx": 1,
        "errorMsg": "員工編號空白"
      }
    ],
    "fail": 2,
    "failDetail": [
      {
        "idx": 2,
        "errorMsg": "員工編號不存在"
      }
    ]
  }
]