회원정보 조회 API (/users/{username}
)
메서드 |
요청 URL |
GET |
http://{SERVER_URL}/api/users/{username} |
Request Header
파라미터 |
타입 |
필수여부 |
설명 |
Authorization |
String |
필수 |
(JWT 토큰) |
Role Requirement
- 권한: 이 작업은
role
이 MASTER
, MANAGER
인 사용자만 수행할 수 있습니다.
Request Elements
파라미터 |
타입 |
필수여부 |
설명 |
username |
String |
필수 |
조회할 사용자 ID |
요청 예시
GET /api/users/user123
Authorization {사용자 AccessToken 헤더 }
Response Elements
필드 |
타입 |
필수여부 |
설명 |
message |
String |
필수 |
응답 메시지 (회원 정보 조회 성공, 권한이 없습니다. 등) |
code |
Integer |
필수 |
HTTP 상태 코드 |
data |
Object |
|
회원 정보 (null일 경우 접근 불가) |
username |
String |
필수 |
사용자 ID |
nickname |
String |
|
사용자의 닉네임 |
email |
String |
필수 |
사용자 이메일 |
role |
String |
필수 |
CUSTOMER , OWNER , MANAGER , MASTER |
created-at |
Timestamp |
필수 |
계정 생성 시간 |
created-by |
String |
필수 |
계정 생성자 |
updated-at |
Timestamp |
|
마지막 수정 시간 |
updated-by |
String |
|
마지막 수정한 사용자 |
응답 예시
{
"message": "회원 정보 조회 성공",
"code": 200,
"data": {
"username": "user123",
"nickname": "nickname",
"email": "[email protected]",
"role": "CUSTOMER",
"is-public": true,
"created-at": "2024-02-12T14:30:00Z",
"created-by": "user123",
"updated-at": "2024-02-15T10:00:00Z",
"updated-by": "adminUser"
}
}
{
"message": "권한이 없습니다.",
"code": 403,
"data": null
}
{
"message": "해당 사용자를 찾을 수 없습니다.",
"code": 404,
"data": null
}