Skip to content

카카오 로그인 api 명세서

Chae Jeong Ah edited this page Jul 12, 2021 · 4 revisions

/auth/user

method route info
POST /auth/user 카카오 로그인

[POST] /auth/user

명세서 보기

Request-Header

Content-Type 만

Request-Body

Name Type Description
access_token String kakao access token
refresh_token String kakao refresh token
{
   "access_token" : "kakao access token",
   "refresh_token" : "kakao refresh token"
}

Respone-Body

Name Type Description
user Object 유저 정보
gruops Array 유저 참여 그룹 고유 id 배열
_id ObjectId 유저 고유 id
name String 유저 이름
email String 유저 이메일
profileImage String 유저 프로필 사진
token String jwt token
access_token String kakao access token
refresh_token String kakao refresh token

카카오 액세스 토큰 만료시 유저의 refresh token이 1개월 미만으로 남았다면 갱신해서 다시 반환합니다.

성공

{
    "status": 200,
    "success": true,
    "message": "유저 로그인 성공", (DB에 없는 새로운 유저일 경우 - "유저 생성 성공")
    "data": {
        "user": {
            "groups": [
                "60e449a7dec4931ad5864094",
                "60e44920dec4931ad5864086",
                "60e44898dec4931ad5864079",
                "60e43ae20dec2a15c9b4192f"
            ],
            "_id": "60e350f58409e94d5ac2bf7c",
            "name": "채정아",
            "email": "[email protected]",
            "profileImage": "http://k.kakaocdn.net/dn/oNADc/btq8mY7WWS2/kfNGuuvyiiOrXzjpK6ff90/img_640x640.jpg",
            "__v": 3
        },
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjp7ImlkIjoiNjBlMzUwZjU4NDA5ZTk0ZDVhYzJiZjdjIn0sImlhdCI6MTYyNTY0ODExNCwiZXhwIjoxNjI2MDA4MTE0fQ.upV10fffM5JCSFnWqpw_N4oMhcXk_XH6h_3EB3ZPj3U",
        "access_token": "iF61v-DI-lWU1SZpgMqmRtu-ANLC8EvGE7wGegopyV8AAAF6gBx6Lw",
        "refresh_token": "goJ3Ui-b_tajXXqDS_aBrDEavJs8wPVv954uvQopyV8AAAF6gBx6LQ"
    }
}

실패 - 500 서버 내부 에러

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

실패 - 401 토큰 만료

{
    "status": 401,
    "success": false,
    "message": "유효하지 않은 토큰"
}