刷卡資料介接

打卡資料寫入

post

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

Required scopes
This endpoint requires the following scopes:
  • : 提供操作 104 企業大師-人資管理 API 權限
Authorizations
OAuth2applicationRequired
Token URL:
Header parameters
authorizationanyRequired

access token

Bodyobject[]
empNostringOptional

員編

Example: A0001
cardTimeinteger · int64Optional

打卡時間timestamp

Example: 1566349095938
Responses
200

success

application/json
post
/hrmapi/external/transferCard
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
OAuth2applicationRequired
Token URL:
Header parameters
authorizationanyRequired

access token

Bodyobject[]
unostringOptional

統編

Example: 123456789
Responses
200

success

application/json
post
/hrmapi/external/transferTpCard
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": "員工編號不存在"
      }
    ]
  }
]
Previous快速上手Next加入 104 人資生態系

Last updated