GET/directory/user-types

사용자 유형 목록을 조회한다.

참고

  • 도메인의 사용자 유형 사용 여부가 'true'로 설정되어 있어야 한다.

Authorization

oauth2

oauth2인증, 자세한 내용은 인가·인증를 참조한다

Scope

directory
directory.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/directory/user-types

Query Parameters

ParameterTypeDescription
domainId integer 

도메인 ID


example : 10000001
format : int32 
count integer 

조회 개수


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

커서값


example : JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA== 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
userTypes array (UserType) 

사용자 유형 정보

 
responseMetaData object (responseMetaData) 

응답 메타데이터

 

UserType

PropertyTypeDescription
domainId integer 

사용자 유형의 도메인 ID


required
format : int32 
userTypeId string 

자동으로 부여되는 ID


readOnly : true 
displayOrder integer 

정렬 순서. 음수와 중복이 허용되며 상대 비교를 통해 오름차순으로 정렬된다.


required
format : int32 
userTypeName string 

사용자 유형명. 도메인 내에서 유일해야 한다. 특수 문자는 !@&()-_+[]{},./만 허용한다.


required
maxLength : 100 
userTypeExternalKey string 

사용자 유형 외부 키. 테넌트 내에서 유일해야 한다.
%#/? 입력 불가


maxLength : 100
nullable : true 
i18nNames array (i18nName) 

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

 
userTypeCode string 

사용자 유형 코드. 영문자(A ~ Z, a ~ z), 숫자(0 ~ 9), 밑줄 기호(_)를 포함해 최대 50자까지 지정할 수 있다. 반드시 영문자로 시작해야 한다.


maxLength : 50
nullable : true 

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  "userTypes": [3    {4      "domainId": 10000001,5      "userTypeId": "employ2c-f321-47a6-ac11-e81fcc23a8c3",6      "displayOrder": 1,7      "userTypeName": "UserType Name",8      "userTypeExternalKey": "USERTYPE_EXT_01",9      "i18nNames": [10        {11          "name": "English Name",12          "language": "en_US"13        }14      ],15      "userTypeCode": "code"16    },17    {18      "domainId": 10000001,19      "userTypeId": "employ0f-997b-4f47-9267-463f15e908a3",20      "displayOrder": 1,21      "userTypeName": "UserType Name2",22      "userTypeExternalKey": "USERTYPE_EXT_02",23      "i18nNames": [24        {25          "name": "English Name",26          "language": "en_US"27        }28      ],29      "userTypeCode": "code"30    }31  ],32  "responseMetaData": {33    "nextCursor": "JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA=="34  }35}

HTTP 403

Forbidden