Grippin Tower v5.0 (GT5)

사용자 목록 조회 API

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

URL

/webapi/ver3/users

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

검색어(이름,아이디)

* UTF-8 URI Encoding 형식
page Number

조회 결과 Page

* Default 1
size Number

조회 결과 개수

* Default 10
sort String

조회 결과 정렬 항목

* Default "userId"

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

조회 결과 정렬 방법

* Default "asc"

* 사용가능 Format "asc" / "desc"
Response
테이블정보입력필요
Name Type Required Description
result String Required API 요청 결과 코드
msg String Required API 요청 결과 상세 메세지
totalElements Number Required 전체 조회 수
totalPages Number Required 전체 페이지 수
pageNumber Number Required 현재 조회 페이지
numberofElement Number Required 페이지 당 조회 개수
users Array 조회 결과 사용자 리스트
테이블정보입력필요
userId String Required ID
userName String Required 이름
status String Required

계정 상태

* enable: 계정활성

* disable: 계정비활성
email String 이메일
mobile String 전화번호
authFailCnt Number Required 인증 실패 횟수
lastAuthDate Date 마지막 인증일시
lastLoginDate Date 마지막 로그인 일시
lastLoginIp String 마지막 로그인 IP
authType String 인증매체
fidoUseYn String Required 생체인증 사용여부
fidoStatus String 생체인증 상태
fidoRegDate String 생체인증 등록일
privateEmail String 개인 이메일
tokens Array 토큰
테이블정보입력필요
tokenId String Required ID
tokenModel String Required 모델
tokenModelCd String Required 모델코드
status String Required 발급상태
userId String Required 토큰 소유자 ID
userName String Required 토큰 소유자 이름
lostYn String Required 분실여부
assignDate Date Required 발급일
Request
Response

사용자 상세 조회 API

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

URL

/webapi/ver3/users/{user_id}

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

사용자 아이디
Response
테이블정보입력필요
Name Type Required Description
result String Required API 요청 결과 코드
msg String Required API 요청 결과 상세 메세지
user Object 사용자 정보
테이블정보입력필요
userId String Required ID
userName String Required 이름
status String Required

계정 상태

* enable: 계정활성

* disable: 계정비활성
email String 이메일
mobile String 전화번호
authFailCnt Number Required 인증 실패 횟수
lastAuthDate Date 마지막 인증일시
lastLoginDate Date 마지막 로그인 일시
lastLoginIp String 마지막 로그인 IP
authType String 인증매체
passwordEnd String 패스워드 만료일까지 남은 일 수
passwordChgDate String 마지막 패스워드 변경일
privateEmail String 개인 이메일
needToSetPasswordYN String 사용자포털 비밀번호 설정 필요 여부
fidoUseYn String Required 생체인증 사용여부
fidoStatus String 생체인증 상태
fidoRegDate String 생체인증 등록일
tokens Array 토큰
테이블정보입력필요
tokenId String Required ID
tokenModel String Required 모델
tokenModelCd String Required 모델코드
status String Required 발급상태
userId String Required 토큰 소유자 ID
userName String Required 토큰 소유자 이름
lostYn String Required 분실여부
assignDate Date Required 발급일
Request
Response

사용자 추가 API

사용자를 추가합니다.

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 요청 결과 상세 메세지
user Object 사용자 정보
테이블정보입력필요
userId String Required ID
userName String Required 이름
status String Required

계정 상태

* enable: 계정활성

* disable: 계정비활성
email String 이메일
mobile String 전화번호
authFailCnt Number 인증 실패 횟수
authType String 인증 타입
fidoUserYn String 생체인증 사용여부
Request
Response