API Reference

User

• 사용자 검색
• 사용자 생성
• 사용자 정보 갱신
• 사용자 삭제

---

User > 사용자 검색

1. API 기본 정보

메서드	요청 URL	설명
GET	/user	Handover 회원 조회

2. 요청변수

변수명	타입	필수여부	기본 값
serviceNumber	String	N	사용자 군번
name	String	N	사용자 이름
groupName	String	N	사용자가 소속된 그룹 이름

3. 출력결과

필드	타입	설명
name	String	사용자 이름
rank	String	사용자 계급
title	String	사용자 직위
group	String	사용자가 속한 부서
email	String	사용자 이메일
tel	String	사용자 전화번호

4. 에러코드

HTTP 코드	에러 메세지	조치방안
401	Authentication Failed: 인증에 실패했습니다.	로그인 세션을 확인해주세요.
403	Forbidden: 권한이 없습니다.
404	Not Found: 검색 결과가 없습니다.
500	Interner Server Error: 데이터베이스 오류입니다.

---

User > 사용자 생성

1. API 기본 정보

메서드	요청 URL	설명
POST	/user	Handover 사용자 생성

2. 요청변수

변수명	타입	필수여부	기본 값
serviceNumber	String	Y	사용자 군번
password	String	Y	사용자 비밀번호
name	String	Y	사용자 이름
rank	String	Y	사용자 계급
title	String	Y	사용자 직위
groupId	String	Y	사용자 소속 부서
email	String	Y	사용자 이메일
tel	String	Y	사용자 전화번호

3. 출력결과

출력결과는 별도로 없으며, 생성이 완료된 경우 HTTP 코드가 201로 반환됩니다.

4. 에러코드

HTTP 코드	에러 메세지	조치방안
400	잘못된 요청	필수 요청 변수들을 모두 입력했는지 확인해주세요.
400	Duplicated Key Error: serviceNumber is already exists.
500	Interner Server Error	서버 내부 오류입니다. 개발자에게 문의해주세요.

---

User > 사용자 정보 갱신

1. API 기본 정보

메서드	요청 URL	설명
UPDATE	/user	Handover 사용자 정보 갱신

2. 요청변수

변수명	타입	필수여부	기본 값
serviceNumber	String	Y	사용자 군번
password	String	N	사용자 비밀번호
name	String	N	사용자 이름
rank	String	N	사용자 계급
title	String	N	사용자 직위
groupId	String	N	사용자 소속 부서
email	String	N	사용자 이메일
tel	String	N	사용자 전화번호

3. 출력결과

출력결과는 별도로 없으며, 변경이 완료된 경우 HTTP 코드가 204로 반환됩니다.

4. 에러코드

HTTP 코드	에러 메세지	조치방안
400	잘못된 요청	필수 요청 변수들을 모두 입력했는지 확인해주세요.
401	Authentication Failed: 인증에 실패했습니다.	로그인 세션을 확인해주세요.
403	Forbidden: 권한이 없습니다.
404	Not Found: 요청한 군번을 찾을 수 없습니다.
500	Interner Server Error	서버 내부 오류입니다. 개발자에게 문의해주세요.

---

User > 사용자 삭제

1. API 기본 정보

메서드	요청 URL	설명
DELETE	/user	Handover 사용자 삭제

2. 요청변수

변수명	타입	필수여부	기본 값
serviceNumber	String	Y	사용자 군번

3. 출력결과

출력결과는 별도로 없으며, 변경이 완료된 경우 HTTP 코드가 204로 반환됩니다.

4. 에러코드

HTTP 코드	에러 메세지	조치방안
400	잘못된 요청	필수 요청 변수들을 모두 입력했는지 확인해주세요.
401	Authentication Failed: 인증에 실패했습니다.	로그인 세션을 확인해주세요.
403	Forbidden: 권한이 없습니다.
404	Not Found: 요청한 군번을 찾을 수 없습니다.
500	Interner Server Error	서버 내부 오류입니다. 개발자에게 문의해주세요.