Grippin Tower v4.0 (GT4)

사용자 목록 조회(검색)

사용자 목록을 조회 및 검색합니다.

URL

/webapi/ver3/users

Request
테이블정보입력필요
Name Type Required Description
q String

검색어(이름,아이디)

* UTF-8 URI Encoding 형식
page Integer

조회 결과 Page

* Default 1
size Integer

조회 결과 개수

* Default 10

* 1 ~ 100 (Min ~ Max)
sort String

조회 결과 정렬 항목

* Default "userId"

* 사용가능 Format "userId" / "userName"
order String

조회 결과 정렬 방법

* Default "asc"

* 사용가능 Format "asc" / "desc"
Response
테이블정보입력필요
Name Type Required Description
result String Required API 요청 결과 코드 (예: "0000")
msg String Required API 요청 결과 메시지
isLdapPass Boolean LDAP 인증 통과 여부
isOtpPass Boolean 승인 코드 성공 여부
totalElements Number 전체 레코드 수
totalPages Number 전체 페이지 수
pageNumber Number 현재 페이지 번호
size Number 조회 레코드 개수
numberofElement Number 현재 페이지 레코드 수
users Array 조회된 사용자 목록
테이블정보입력필요
userId String 사용자 아이디
userName String 사용자 이름
status String

계정 상태

* enable: 계정 활성

* disable: 계정비활성
email String 이메일 주소
authFailCnt Number 인증 실패 횟수
lastAuthDate String 마지막 인증 성공 일시
lang String 언어 설정 (예: ko)
needToSetPasswordYN String 로그인용 비밀번호 설정 필요 여부
authType String 인증 방식
fidoStatus String 생체인증 상태 코드
fidoStatusInfo String 생체인증 상세 설명
fidoUseYn String 생체인증 사용 여부
tokens Array 발급된 토큰 목록
테이블정보입력필요
tokenId String 토큰 ID
tokenModel String 토큰 모델명
stauts String 발급 상태
userId String 토큰 소유자 ID
lostYn String 분실 여부
endDate String 토큰 만료 일시
assignDate String 토큰 발급 일시
tokenModelCd String 토큰 모델 코드
Request
Response

사용자 추가

사용자를 추가합니다.

URL

/webapi/ver3/users

Request
테이블정보입력필요
Name Type Required Description
userId String Required

사용자 아이디
userName String Required

사용자 이름

* UTF-8 URI Encoding 형식
email String

이메일 주소

* 암호화 사용시,

AES 암호화 후 Base64 encoding
mobile String

전화번호

* 암호화 사용시,

AES 암호화 후 Base64 encoding
Response
테이블정보입력필요
Name Type Required Description
result String Required API 요청 결과 코드
msg String Required API 요청 결과 메시지
users Object 조회된 사용자 목록
테이블정보입력필요
userId String 사용자 아이디
userName String 사용자 이름
status String

계정 상태

* enable: 계정 활성

* disable: 계정비활성
authFailCnt Number 인증 실패 횟수
lang String 언어 설정 (예: ko)
needToSetPasswordYN String 사용자포털 비밀번호 설정 필요 여부
Request
Response

사용자 조회

사용자 상세 정보를 조회합니다.

URL

/webapi/ver3/users/{user_id}

Request
테이블정보입력필요
Name Type Required Description
userId String Required

사용자 아이디
Response
테이블정보입력필요
Name Type Required Description
result String Required API 요청 결과 코드 (예: "0000")
msg String Required API 요청 결과 메시지
isLdapPass Boolean LDAP 인증 통과 여부
isOtpPass Boolean 승인 코드 성공 여부
user Object 조회된 사용자
테이블정보입력필요
userId String 사용자 아이디
userName String 사용자 이름
status String

계정 상태

* enable: 계정 활성

* disable: 계정비활성
email String 이메일 주소
mobile String 전화번호
authFailCnt Number 인증 실패 횟수
lastAuthDate String 마지막 인증 성공 일시
lastLoginDate String 마지막 로그인 성공 일시
passwordEnd Integer

고정패스워드 남은 사용 기간

* 음수일 시 경과
passwordChgDate String 비밀번호 변경 일시
lang String 언어 설정 (예: ko)
needToSetPasswordYN String 사용자포털 비밀번호 설정 필요 여부
authType String 인증 방식
fidoStatus String 생체인증 상태 코드
fidoStatusInfo String 생체인증 상세 설명
fidoAaidInfo String 생체인증 AAID 정보
fidoRegDate String 생체인증 등록 일시
fidoUseYn String 생체인증 사용 여부
tokens Array 발급된 토큰 목록
테이블정보입력필요
tokenId String 토큰 ID
tokenModel String 토큰 모델명
status String 발급 상태
userId String 토큰 소유자 ID
lostYn String 분실 여부
endDate String 토큰 만료 일시
assignDate String 토큰 발급일시
tokenModelCd String 토큰 모델 코드
Request
Response