Human Resource API

Human Resource API로 아래와 같은 기능을 제공한다.

  • 인사 부가 정보를 생성/조회/수정/삭제할 수 있다.
  • 구성원의 부가 정보를 조회/수정할 수 있다.
  • 휴직 구분 설정 정보를 생성/조회/수정/삭제할 수 있다.
  • 휴직자 목록을 조회할 수 있다.

Human Resource API를 호출하려면 구성원 계정 또는 서비스 계정으로 인정하여 얻은 Access Token 이 필요하다. API Scope 는 businessSupport.humanResource, businessSupport.humanResource.read이다.

인사 부가 정보 설정 {#extension-properties}

다음 API로 인사 부가 정보를 관리할 수 있다.

HTTP RequestDescription
POST /business-support/human-resource/extension-properties인사 부가 정보 추가
GET /business-support/human-resource/extension-properties인사 부가 정보 목록 조회
GET /business-support/human-resource/extension-properties/{extensionPropertyId})인사 부가 정보 조회
PATCH /business-support/human-resource/extension-properties/{extensionPropertyId}인사 부가 정보 부분 수정
DELETE /business-support/human-resource/extension-properties/{extensionPropertyId}인사 부가 정보 삭제

구성원 부가 정보 {#user-extension-properties}

다음 API로 구성원의 부가 정보를 관리할 수 있다.

HTTP RequestDescription
GET /business-support/human-resource/user/{userId}/extension-properties구성원 부가 정보 목록 조회
GET /business-support/human-resource/user/{userId}/extension-properties/{extensionPropertyId})구성원 부가 정보 조회
PATCH /business-support/human-resource/user/{userId}/extension-properties/{extensionPropertyId}구성원 부가 정보 부분 수정

휴직 구분 설정 {#leave-of-absence}

다음 API로 휴직 구분을 관리할 수 있다.

business-support-human-resource-leave-of-absence-list

HTTP RequestDescription
POST /business-support/human-resource/leave-of-absences휴직 구분 추가
GET /business-support/human-resource/leave-of-absences휴직 구분 목록 조회
GET /business-support/human-resource/leave-of-absences/{leaveOfAbsenceId})휴직 구분 조회
PATCH /business-support/human-resource/leave-of-absences/{leaveOfAbsenceId}휴직 구분 부분 수정
DELETE /business-support/human-resource/leave-of-absences/{leaveOfAbsenceId}휴직 구분 삭제

휴직자 목록 조회 {#on-leave-users}

다음 API로 휴직 중인 구성원을 조회할 수 있다.

HTTP RequestDescription
GET /business-support/human-resource/on-leave-users휴직자 목록 조회