📌 카카오 로그인 API 연동 - 3단계: 액세스 토큰으로 사용자 정보 요청

My Pale Blue Dot·2025년 5월 13일

API Spring SrpingBoot kakao 사용자 정보 요청 엑세스 토큰 카카오

SPRING BOOT

목록 보기

20/40

📅 날짜

2025-05-13

🔁 전체 로그인 흐름 요약

[사용자 → 카카오 로그인 요청]
      ↓
[인가 코드 발급] (1단계)
      ↓
[인가 코드 → 액세스 토큰 요청] (2단계)
      ↓
[액세스 토큰으로 사용자 정보 요청] ← 지금 단계! (3단계)
      ↓
[사용자 정보로 회원가입/로그인 처리]

📝 학습 내용

✅ 1. 개요

액세스 토큰을 이용해 카카오 사용자 정보를 요청함
사용자 정보는 id, nickname, email, profile_image 등
응답 결과는 DTO로 매핑하여 Thymeleaf 등 템플릿에 전달 가능

✅ 2. API 요청 정보

항목	값
요청 URL	`https://kapi.kakao.com/v2/user/me`
METHOD	`POST` 또는 `GET` (POST 권장)
인증 방식	`Authorization: Bearer {ACCESS_TOKEN}`

✅ 3. 요청 헤더

헤더	설명	필수
Authorization	액세스 토큰 (`Bearer ...`)	✅
Content-Type	`application/x-www-form-urlencoded;charset=utf-8`	✅

4️⃣ 사용자 정보 요청 코드 (Spring Boot)

private KakaoProfileResponse kakaoProfileResponse;

@GetMapping("/main")
public void main(Model model) {
    log.info("GET /kakao/main...");

    String url = "https://kapi.kakao.com/v2/user/me";

    HttpHeaders header = new HttpHeaders();
    header.add("Authorization", "Bearer " + this.kakaoTokenResponse.getAccess_token());
    header.add("Content-Type", "application/x-www-form-urlencoded;charset=utf-8");

    HttpEntity entity = new HttpEntity<>(header);

    RestTemplate rt = new RestTemplate();
    ResponseEntity<KakaoProfileResponse> response = rt.exchange(
        url,
        HttpMethod.POST,
        entity,
        KakaoProfileResponse.class
    );

    this.kakaoProfileResponse = response.getBody();
    model.addAttribute("profile", this.kakaoProfileResponse);

    System.out.println(this.kakaoProfileResponse);
}

✅ KakaoProfileResponse DTO

@Data
private static class KakaoProfileResponse {
    public long id;
    public Date connected_at;
    public Properties properties;
    public KakaoAccount kakao_account;
}

@Data
private static class Properties {
    public String nickname;
    public String profile_image;
    public String thumbnail_image;
}

@Data
private static class KakaoAccount {
    public boolean profile_nickname_needs_agreement;
    public boolean profile_image_needs_agreement;
    public Profile profile;
    public boolean has_email;
    public boolean email_needs_agreement;
    public boolean is_email_valid;
    public boolean is_email_verified;
    public String email;
}

@Data
private static class Profile {
    public String nickname;
    public String thumbnail_image_url;
    public String profile_image_url;
    public boolean is_default_image;
    public boolean is_default_nickname;
}

🖥️ 사용자 정보 출력 뷰 (Thymeleaf)

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.w3.org/1999/xhtml">
<head>
    <meta charset="UTF-8">
    <title>카카오 로그인 성공</title>
</head>
<body>
<h1>메인 페이지</h1>
<hr/>

<!-- 전체 응답 DTO 출력 -->
<div th:text="${profile}"></div>

<!-- 선택적: 개별 정보 출력 -->
<!-- <p th:text="${profile.kakao_account.email}"></p> -->
<!-- <img th:src="${profile.kakao_account.profile.profile_image_url}" /> -->
</body>
</html>