GET/directory/profile-statuses

상태 목록을 조회한다.
상태는 도메인 당 최대 10개까지 가질 수 있기 때문에 한번에 모든 상태를 내려준다.

Authorization

oauth2

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

Scope

directory
directory.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/directory/profile-statuses

Query Parameters

ParameterTypeDescription
domainId integer 

도메인 ID


example : 10000001
format : int32 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
profileStatuses array (ProfileStatus) 

상태 정보

 

ProfileStatus

PropertyTypeDescription
domainId integer 

도메인 ID


required
format : int32 
profileStatusId string 

상태 ID

  • 기본 상태 : BUSY(바쁨) , AWAY(자리비움), LEAVE_OFFICE(퇴근), ABSENCE(부재)
  • 커스텀 상태: CUSTOM01~CUSTOM12

required
Allowed values : BUSY, AWAY, LEAVE_OFFICE, ABSENCE, CUSTOM01, CUSTOM02, CUSTOM03, CUSTOM04, CUSTOM05, CUSTOM06, CUSTOM07, CUSTOM08, CUSTOM09, CUSTOM10, CUSTOM11, CUSTOM12 
iconType string 

아이콘 타입

iconTypeimageiconTypeimage
BUSYALT​AT_OFFICE​ALT
URGENTALT ​EDUCATION​ALT
FOCUS_MODE​ALTWORKING_OUTSIDE​ALT
PHONE​ALTBUSINESS_TRIP​ALT
MEETING​ALTOFF​ALT
AWAY​ALTHALF_DAY​ALT
BACK_SOON​ALTVACATION​ALT
EATING​ALTABSENCE​ALT
TEA_TIME​ALTSICK_LEAVE​ALT
AT_HOME​ALTLEAVE_OF_ABSENCE​ALT
ACTION​ALTONLINE​ALT

required
Allowed values : BUSY, URGENT, FOCUS_MODE, PHONE, MEETING, AWAY, BACK_SOON, EATING, TEA_TIME, AT_HOME, AT_OFFICE, EDUCATION, WORKING_OUTSIDE, BUSINESS_TRIP, OFF, HALF_DAY, VACATION, ABSENCE, SICK_LEAVE, LEAVE_OF_ABSENCE, ACTION, ONLINE 
useDefaultStatus boolean 

기본 상태 사용 여부

  • true: 기본 상태를 사용
  • false: 기본 상태를 사용 안함
  • 커스텀 상태는 true/false 값을 설정해도 항상 true로 해당 설정의 영향을 받지 않는다.

default : true 
enableSettingByUser boolean 

서비스에서 사용자가 상태 설정 가능 여부


default : true 
profileStatusName string 

상태 이름

  • 기본 상태는 이름 변경이 불가능하다.
  • 다른 상태와 중복된 이름을 허용하지 않는다.

required
maxLength : 20 
i18nNames array (i18nName) 

다국어 이름

  • 기본 상태는 다국어 이름 변경이 불가능하다.
  • 다른 상태와 중복된 다국어 이름을 허용하지 않는다.
  • 같은 상태의 다국어 이름은 중복이 가능하다.

minItems : 0 
displayOrder integer 

상태 순서

  • 0보다 큰 양수 값이어야 한다.
  • 상태끼리 중복된 값을 허용하지 않는다.

required
minimum : 1
format : int32 

i18nName

PropertyTypeDescription
name string 

다국어 이름


required
maxLength : 20 
language string 

다국어 언어 코드


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

Response Example

example

1{2  "profileStatuses": [3    {4      "domainId": 10000001,5      "profileStatusId": "BUSY",6      "iconType": "BUSY",7      "useDefaultStatus": false,8      "enableSettingByUser": false,9      "profileStatusName": "바쁨",10      "i18nNames": [11        {12          "name": "BUSY",13          "language": "en_US"14        }15      ],16      "displayOrder": 117    },18    {19      "domainId": 10000001,20      "profileStatusId": "CUSTOM01",21      "iconType": "TEA_TIME",22      "useDefaultStatus": true,23      "enableSettingByUser": false,24      "profileStatusName": "티타임",25      "i18nNames": [26        {27          "name": "TEA TIME",28          "language": "en_US"29        }30      ],31      "displayOrder": 232    }33  ]34}

HTTP 403

Forbidden