- 요청 처리(status)
| 응답코드 |
상태 |
상세 설명 |
| 200 |
OK |
요청이 성공적으로 되었습니다. 정보는 요청에 따른 응답으로 반환됩니다. |
| 400 |
Bad Request |
이 응답은 잘못된 문법으로 인하여 서버가 요청하여 이해할 수 없음을 의미합니다. |
| 401 |
UNAUTHORIZED |
비록 HTTP 표준에서는 '미승인(unauthorized)'를 명확히 하고 있지만, 의미상 이 응답은 '비인증(unauthenticated)'를 의미합니다. 클라이언트는 요청한 응답을 받기 위해서는 반드시 스스로를 인증해야 합니다. |
| 403 |
Forbidden |
비록 HTTP 표준에서는 '미승인(unauthorized)'를 명확히 하고 있지만, 의미상 이 응답은 '비인증(unauthenticated)'를 의미합니다. 클라이언트는 요청한 응답을 받기 위해서는 반드시 스스로를 인증해야 합니다. |
| 404 |
Not Found |
서버는 요청받은 리소스를 찾을 수 없습니다. 브라우저에서는 알려지지 않은 URL을 의미합니다. 이것은 API에서 종점은 적절하지만 리소스 자체는 존재하지 않음을 의미할 수 있습니다. 서버들은 인증받지 않은 클라이언트로부터 리소스를 숨기기 위하여 이 응답을 403 대신에 전송할 수도 있습니다. 이 응답 코드는 웹에서 반복적으로 발생하기 때문에 가장 유명할지도 모릅니다. |
| 500 |
Internal Server Error |
웹 사이트 서버에 문제가 있음을 의미하지만 서버는 정확한 문제에 대해 더 구체적으로 설명할 수 없습니다. |
- 1xx(정보) : 요청을 받았으며 프로세스를 계속 진행합니다.
- 2xx(성공) : 요청을 성공적으로 받았으며 인식했고 수용하였습니다.
- 3xx(리다이렉션) : 요청 완료를 위해 추가 작업 조치가 필요합니다.
- 4xx(클라이언트 오류) : 요청의 문법이 잘못되었거나 요청을 처리할 수 없습니다.
- 5xx(서버 오류) : 서버가 명백히 유효한 요청에 대한 충족을 실패했습니다.
- 그 외 상태코드 참고 사이트
- 로그인 요청
- POST 요청
request body {
“email” : “[email protected]”,
“password” : “1234”
}
- Response
// 로그인 성공인 경우
{
"status": "OK",
"message": "로그인 성공",
"data": {
"email": "[email protected]",
"accessToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJoaXRoZXJlMTAxMkBuYXZlci5jb20iLCJyb2xlcyI6WyJST0xFX1VTRVIiXSwiaWF0IjoxNjU4OTY4ODI4LCJleHAiOjE2NTg5NzI0Mjh9.I-rI0TRvgNiaJBe6XLMhtsgCEy2lLmVtw2LwdzaXA8M",
"refreshToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJoaXRoZXJlMTAxMkBuYXZlci5jb20iLCJyb2xlcyI6WyJST0xFX1VTRVIiXSwiaWF0IjoxNjU4OTY4ODI4LCJleHAiOjE2NTk1NzM2Mjh9.h0HXvN-Jt0R5iCxJVOOPQ9nmHTeQTYy6i2r9PeilmnU",
"id": 2,
"nick": "오운완최고",
"gender": "FEMALE",
"age": 20,
"height": 170,
"weight": 40,
"activityNum": 3,
"activityHour": 1,
"activityLevel": 2
}
}
// 로그인 실패(이메일이나 비밀번호가 다른 경우)
{
"status": "BAD_REQUEST",
"message": "이메일 혹은 비밀번호가 맞지 않습니다.",
"data": null
}
// 회원가입은 되었지만 아직 이메일 인증 받지 못한 경우
{
"status": "BAD_REQUEST",
"message": "회원가입 이메일 인증이 필요합니다.",
"data": null
}
// 서버 에러
{
"status": "INTERNAL_SERVER_ERROR",
"message": "서버 에러 발생",
"data": null
}
- 로그인 후 얻은 access token, refresh token 설정
// 로그인된 상태로 하는 모든 요청에 헤더값에
// 위에서 로그인 후 얻은 access token 값을 넣어줘야함
header key : X-AUTH-TOKEN
value : 로그인 후 얻은 access token값
// access token이 만료되면 refresh token으로 access token을 재발급 받아야함
// 이런 경우에만 추가적으로 refresh token값을 넣을 수 있는 header를 추가해야함
header key : REFRESH-TOKEN
value : 로그인 후 얻은 refresh token값