User Auth API

• User Auth API
  • Sign up API
    • Request
    • Response
  • Login API
    • Request
    • Response
  • Logout API
    • Request
    • Response
  • Sign out API
    • Reqeust
    • Response

User Auth API

Sign up API

Request

• url

  /v1/user/sign-up

• method

  POST

• header

  method	parameter	Description	Required
  Content-Type	application/json

• request body

  {
      "userId": {{String}},
      "userName": {{String}},
      "email": {{String}},
      "accessToken": {{String}},
      "nickName": {{String}},
      "address": {{Long}},
      "category": [],
      "intro": {{Long}}
  }
  

  Field	Type	Description	Example	Required
  userId	String	카카오톡에서 받아오는 유저 oauthId		O
  userName	String	카카오톡에서 받아오는 유저 이름		O
  email	String	카카오톡에서 받아오는 유저 이메일		O
  accessToken	String	로그인 토큰		O
  nickName	String	유저 닉네임(중복X)		O
  address	Long	위치		O
  category	List	관심 종목		O
  intro	String	자기소개		O

Response

• success response

  • header

    method	parameter	Description	Required
    Authorization	{{token}}	access token	O

  • body

    {
        "status": 200,
        "success": true,
        "message": "회원가입을 축하드립니다!\n운동플래닛과 건강한 운동생활을\n시작해보세요!"
    }
    

    Field	Type	Description	Example	Required
    status	integer	HTTP STATUS CODE	200	O
    success	boolean	성공 여부	true	O
    message	String	회원가입 성공 메세지		O

• fail response

  • request body 값이 비어있는 경우

  {
      "status": 400,
      "success": false,
      "message": "필요한 값이 없습니다"
  }
  

  • 이미 가입 된 사용자일 경우

  {
      "status": 400,
      "success": false,
      "message": "이미 가입한 사용자입니다"
  }
  

  • 닉네임 중복일 경우

  {
      "status": 500,
      "success": false,
      "message": "중복된 닉네임입니다"
  }
  

  • 서버 내부 오류

  {
      "status": 500,
      "success": false,
      "message": "서버 내부 오류"
  }
  

  Field	Type	Description	Example	Required
  status	integer	HTTP STATUS CODE	500	O
  success	boolean	성공 여부	false	O
  message	String	서버 내부 오류 실패 메세지		O

Login API

Request

• url

  /user/sign-in

• method

  POST

• header

  method	parameter	Description	Required
  Content-Type	application/json
  token	{token}		O

• request body

  {
      "userId": {{String}},
      "email": {{String}},
      "accessToken": {{String}},
      "nickName": {{String}}
  }
  

  Field	Type	Description	Example	Required
  userId	String	카카오톡에서 받아오는 유저 oauthId		O
  email	String	카카오톡에서 받아오는 유저 이메일
  accessToken	String	로그인 토큰		O
  nickName	String	유저 닉네임(중복X)

Response

• success response

  {
      "status": 200,
      "success": true,
      "message": "로그인 성공"
  }
  

  Field	Type	Description	Example	Required
  status	integer	HTTP STATUS CODE	200	O
  success	boolean	성공 여부	true	O
  message	String	회원가입 성공 메세지		O

• fail response

  • 회원 가입이 필요한 경우

  {
      "status": 400,
      "success": false,
      "message": "회원 가입이 필요합니다"
  }
  

  • 서버 내부 오류

  {
      "status": 500,
      "success": false,
      "message": "서버 내부 오류"
  }
  

  Field	Type	Description	Example	Required
  status	integer	HTTP STATUS CODE	500	O
  success	boolean	성공 여부	false	O
  message	String	서버 내부 오류 실패 메세지		O

Logout API

Request

• url

  /logout

• method

{

}

Field	Type	Description	Example	Required
userName	String	카카오톡에서 받아오는 유저 이름		O
email	String	카카오톡에서 받아오는 유저 이메일		O
accessToken	String	로그인 토큰		O

Response

• success response

• fail response

  • 서버 내부 오류

  {
      "status": 500,
      "success": false,
      "message": "서버 내부 오류"
  }
  

  Field	Type	Description	Example	Required
  status	integer	HTTP STATUS CODE	500	O
  success	boolean	성공 여부	false	O
  message	String	서버 내부 오류 실패 메세지		O

Sign out API

Reqeust

• url

  /sign-out

• method

  ``

{

}

Field	Type	Description	Example	Required

Response

• success response

• fail response

  • 서버 내부 오류

  {
      "status": 500,
      "success": false,
      "message": "서버 내부 오류"
  }
  

  Field	Type	Description	Example	Required
  status	integer	HTTP STATUS CODE	500	O
  success	boolean	성공 여부	false	O
  message	String	서버 내부 오류 실패 메세지		O