GET/directory/user-types/external-keys

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

Authorization

oauth2

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

Scope

directory
directory.read

HTTP Request

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

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== 
hasExternalKey boolean 

externalKey 여부로 필터링

  • true : externalKey 값이 있는 리소스로 필터링
  • false : externalKey 값이 없는 리소스로 필터링
  • 지정하지 않은 경우에는 모든 리소스를 가져온다.

example : false 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
userTypes array (DomainUniqueExternalKeyResponse) 

사용자 유형 정보

 
responseMetaData object (responseMetaData) 

응답 메타데이터

 

DomainUniqueExternalKeyResponse

PropertyTypeDescription
domainId integer 

도메인 ID


format : int32
readOnly : true 
name string 

이름


readOnly : true 
id string 

ID.

조회 시 리소스에 자동 부여된 ID가 반환된다.


readOnly : true 
externalKey string 

고객사에서 관리하는 외부 키.


readOnly : true 

responseMetaData

PropertyTypeDescription
nextCursor string 

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

 

Response Example

example

1{2  "userTypes": [3    {4      "domainId": 10000001,5      "name": "name01",6      "id": "employ2c-f321-47a6-ac11-e81fcc23a8c3",7      "externalKey": "USERTYPE_EXT_01"8    },9    {10      "domainId": 10000001,11      "name": "name02",12      "id": "employ0f-997b-4f47-9267-463f15e908a3",13      "externalKey": "USERTYPE_EXT_02"14    }15  ],16  "responseMetaData": {17    "nextCursor": "JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA=="18  }19}