GET/business-support/attendance/users/{userId}/status

사용자의 현재 출퇴근 상태를 조회한다.

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증를 참고한다.

Scope

businessSupport.attendance
businessSupport.attendance.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/business-support/attendance/users/{userId}/status

Path Parameters

ParameterTypeDescription
userId string 

사용자 ID


required
example : be1047ee-0eda-45d3-1867-03a9c2c4e402 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Request Body

Response

HTTP 200

출퇴근 상태 정보

PropertyTypeDescription
timecardId string 

사용자 출퇴근의 타임카드 ID

 
userId string 

사용자 ID


example : be1047ee-0eda-45d3-1867-03a9c2c4e402 
userName string 

사용자 이름

 
baseDate string 

출퇴근 기준일자

  • 형식: YYYY-MM-DD
 
status string 

상태

  • READY_TO_CLOCK: 출퇴근이 가능한 상태
  • CLOCKED_IN: 출근한 상태
  • CLOCKED_OUT: 퇴근한 상태
  • HOLIDAY: 휴일이어서 출퇴근이 불가능한 상태
  • NO_WORK_HOURS: 근무시작시간 전이어서 출근이 불가능한 상태
  • NO_WORK_TYPE: 근무방식이 지정이 안되어서 출퇴근이 불가능한 상태
  • UNAVAILABLE: 기타로 출퇴근이 불가능한 상태

Allowed values : READY_TO_CLOCK, CLOCKED_IN, CLOCKED_OUT, HOLIDAY, NO_WORK_HOURS, NO_WORK_TYPE, UNAVAILABLE 
isAutoClockOut boolean 

퇴근 시간 자동 체크 여부

 

Response Example

Example 1

1{2  "timecardId": "96b02530-82de-41c8-8223-3055c74e705e_a6694d6128ed806e5ff490dad42e3fad",3  "userId": "userf7da-f82c-4284-13e7-030f3b4c756x",4  "userName": "홍길동",5  "baseDate": "2024-06-03",6  "status": "READY_TO_CLOCK",7  "isAutoClockOut": false8}