GET/business-support/attendance/absences

회사의 부재 항목 목록을 조회한다.

Authorization

oauth2

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

Scope

businessSupport.attendance
businessSupport.attendance.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/business-support/attendance/absences

Query Parameters

ParameterTypeDescription
count integer 

목록 조회 개수


minimum : 1
maximum : 100
example : 100
format : int32 
cursor string 

다음 목록 조회 시 사용하는 값


example : JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA== 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

부재 항목 목록

PropertyTypeDescription
absences array (Absence) 
 
responseMetaData object (responseMetaData) 

응답 메타데이터

 

Absence

PropertyTypeDescription
absenceId string 

부재 항목 ID

 
absenceName string 

부재 항목 명


required 
i18nNames array (i18nName) 

다국어 목록 정보.
Admin > 기본환경 > 회사 정보 > 다국어 설정에서 지정된 항목의 다국어만 표시된다.

 
leaveType string 

휴가 구분

  • NONE: 해당 없음
  • ANNUAL_LEAVE: 연차
  • BUSINESS_TRIP: 출장
  • FAMILY_EVENT: 경조
  • SPECIAL_LEAVE: 특별휴가

required
Allowed values : NONE, ANNUAL_LEAVE, BUSINESS_TRIP, FAMILY_EVENT, SPECIAL_LEAVE 
timeUnit string 

부재 사용 시간 단위

  • ADAY: 종일
  • HALF_DAY: 반일
  • ONE_HOUR: 1시간
  • TWO_HOURS: 2시간
  • HALF_HOUR: 30분

required
Allowed values : ADAY, HALF_DAY, ONE_HOUR, TWO_HOURS, HALF_HOUR 
isWorkingHours boolean 

근로 시간에 합산 여부


default : false 
isActualWork boolean 

실제 근로 여부


default : false 
isAllowExceedStandardHours boolean 

기준 근로 시간 초과 연차 사용 허용 여부
leaveType이 ANNUAL_LEAVE(연차)인 경우만 적용되는 옵션


default : false 
isIncludeAnnualCalculation boolean 

연차 산정 출근 일수 포함 여부

 
enabled boolean 

사용 여부


default : false 
displayOrder integer 

노출 순서


format : int32 

i18nName

PropertyTypeDescription
name string 

다국어 이름


required
minLength : 1
maxLength : 100 
language string 

다국어 언어 코드


required
Allowed values : ko_KR, en_US, ja_JP, zh_CN, zh_TW 

responseMetaData

PropertyTypeDescription
nextCursor string 

다음 목록 조회 시 사용하는 커서값

 

Response Example

Example

1{2  "absences": [3    {4      "absenceId": "97e1ef5c-1f35-4f64-81cc-65074ef3e26c",5      "absenceName": "연차",6      "i18nNames": [7        {8          "language": "ja_JP",9          "name": "年次"10        },11        {12          "language": "en_US",13          "name": "Annual"14        }15      ],16      "leaveType": "ANNUAL_LEAVE",17      "timeUnit": "ADAY",18      "displayOrder": 1,19      "isActualWork": false,20      "isWorkingHours": true,21      "isAllowExceedStandardHours": false,22      "enabled": true23    },24    {25      "absenceId": "a5280a83-9a90-4ad3-a81e-38ec6deadf6a",26      "absenceName": "재택근무",27      "i18nNames": [28        {29          "language": "ja_JP",30          "name": "在宅勤務"31        },32        {33          "language": "en_US",34          "name": "Remote works"35        }36      ],37      "leaveType": "NONE",38      "timeUnit": "HALF_DAY",39      "displayOrder": 2,40      "isActualWork": true,41      "isWorkingHours": true,42      "isAllowExceedStandardHours": false,43      "isIncludeAnnualCalculation": false,44      "enabled": true45    }46  ],47  "responseMetaData": {48    "nextCursor": "H4sIAAAAAAAAAKuuBQBDv6ajAgAAAA"49  }50}