[공지] 카카오계정 프로필 정보 변경사항 안내 / [Change Notice] Kakao Account Profile Information

Notice / 공지
#1

안녕하세요. 카카오입니다.

보다 효율적이고 유용한 데이터를 제공하고자,
사용자 정보 가져오기 API를 통해 제공되는 프로필 정보가 2021년 6월 1일부터 변경될 예정임을 알려 드립니다.

적용일시

  • 2021년 6월 1일 화요일

대상

  • 카카오 로그인 > 사용자 정보 가져오기 (/v2/user/me)

변경 사항

  • 사용자가 프로필 사진을 등록하지 않아 기본 프로필 사진을 사용하는 경우에도 프로필 사진(profile_image_url, thumbnail_image_url) 응답 필드 제공하도록 변경

  • 기본 프로필 사진 여부(is_default_image) 응답 필드 추가

  • REST API 응답의 변경 사항 적용 예시

// 변경 전
// 사용자가 직접 등록한 프로필 사진이 없는 경우
// 프로필 사진 응답 필드가 제공되지 않음
{
  ...,
  "kakao_account":{
    "profile_needs_agreement": false, 
    "profile":{
      "nickname": "홍길동"
    },
    ...
  }
}

// 변경 후
// 사용자가 직접 등록한 프로필 사진이 없는 경우
// 기본 프로필 사진 정보, 기본 프로필 썸네일 이미지 정보, 기본 프로필 사진 여부 응답 필드 제공
{
  ...,
  "kakao_account":{
    "profile_needs_agreement": false, 
    "profile":{
      "nickname": "홍길동",
      "thumbnail_image_url": "<Image>",
      "profile_image_url": "<Image>",
      "is_default_image": true
    },
    ...
  }
}

필요한 조치 사항

  • 기본 프로필 사진 여부 판단 시, 프로필 사진(profile_image_url, thumbnail_image_url) 응답 필드의 유무가 아닌 기본 이미지 여부(is_default_image) 응답 필드를 참조하도록 수정

참고

위 변경 사항에 대해 궁금하신 점은 데브톡으로 문의해 주시기 바랍니다.
언제나 더 좋은 서비스를 제공하기 위해 최선을 다 하겠습니다.

감사합니다.


=====


Hello. This is Kakao.

We inform you that the profile information provided through the Retrieving user information API will be changed from June 1, 2021, to provide you with efficient and meaningful data.

Effective Date

  • On Tuesday, June 1, 2021

Target

  • Kakao Login > Retrieving User Information (/v2/user/me)

Changes

  • Add the is_default_image field that indicates whether the profile image is the default profile image or not.

  • Provide the thumbnail_image_url and profile_image_url fields even if a user has not registered a profile image ( "is_default_image": true).

  • Example of REST API response:

// Before change
// If user has not registered any profile image
// the field for profile image is not returned in the response.
{
  ...,
  "kakao_account":{
    "profile_needs_agreement": false, 
    "profile":{
      "nickname": "홍길동"
    },
    ...
  }
}

// After change
//  If user has not registered any profile image
// the response includes the fields for default profile image, profile thumbnail image and whether or not the image is set as default.. 
{
  ...,
  "kakao_account":{
    "profile_needs_agreement": false, 
    "profile":{
      "nickname": "홍길동",
      "thumbnail_image_url": "<Image>",
      "profile_image_url": "<Image>",
      "is_default_image": true
    },
    ...
  }
}

What to do

  • To check if the default profile image is used, change your code to use is_default_image, instead of checking the presence of profile image URL (profile_image_url/thumbnail_image_url) in the response.

Reference

If you have any further question about the changes above, contact us at DevTalk.

We always do our best to provide a better service.

Thank you.

카카오 로그인 시 is_default_image 키 발생 사유
Kakao_account.profile 정보가 내려오지 않습니다
MeV2Response 응답 중 nickname이 내려오지 않습니다
#2