카카오 사용자 정보조회 API (/v2/user/me) 응답 특성

> 카카오 디벨로퍼스 "사용자 정보 조회 REST API" 가이드 

* 생년월일과 성별은 https://accounts.kakao.com/에서 수정할 수 있음 

https://accounts.kakao.com/

 

* 이메일, 성별, 생일 등 카카오 계정에 정보가 등록되어 있지 않다면 응답 항목에 제거 되어 전달됨.

정보가 있을때
{"age_range_needs_agreement":false,"age_range": "20~29"}
정보가 없을때
{"age_range_needs_agreement":false}

* 동의 항목에 "수집"옵션을 체크하면 해당 정보가 없을 때 카카오 로그인 시점 입력 받아 사용자 정보조회에서 전달함.

<정보가 없는 경우 입력 받는 "수집" 옵션>

* 카카오 싱크 도입으로 CI 필수 동의 설정한 경우, 본인 확인 안된 계정은 본인 확인 절차 수행

<CI 필수 동의에 따른 로그인 중, 본인 확인>

 

 

 

kakao_account

Name	Type	Description	Required
profile_needs_agreement	Boolean	사용자 동의 시 프로필 정보(닉네임/프로필 사진) 제공 가능 필요한 동의 항목: 프로필 정보(닉네임/프로필 사진)	X
profile_nickname_needs_agreement	Boolean	사용자 동의 시 닉네임 제공 가능 필요한 동의 항목: 닉네임	X
profile_image_needs_agreement	Boolean	사용자 동의 시 프로필 사진 제공 가능 필요한 동의 항목: 프로필 사진	X
profile	JSON	프로필 정보 필요한 동의 항목: 프로필 정보(닉네임/프로필 사진), 닉네임, 프로필 사진	X
email_needs_agreement	Boolean	사용자 동의 시 카카오계정 대표 이메일 제공 가능 필요한 동의 항목: 카카오계정(이메일)	X
is_email_valid	Boolean	이메일 유효 여부 true: 유효한 이메일 false: 이메일이 다른 카카오계정에 사용돼 만료 필요한 동의 항목: 카카오계정(이메일)	X
is_email_verified	Boolean	이메일 인증 여부 true: 인증된 이메일 false: 인증되지 않은 이메일 필요한 동의 항목: 카카오계정(이메일)	X
email	String	카카오계정 대표 이메일 필요한 동의 항목: 카카오계정(이메일)	X
age_range_needs_agreement	Boolean	사용자 동의 시 연령대 제공 가능 필요한 동의 항목: 연령대	X
age_range	String	연령대 1~9: 1세 이상 10세 미만 10~14: 10세 이상 15세 미만 15~19: 15세 이상 20세 미만 20~29: 20세 이상 30세 미만 30~39: 30세 이상 40세 미만 40~49: 40세 이상 50세 미만 50~59: 50세 이상 60세 미만 60~69: 60세 이상 70세 미만 70~79: 70세 이상 80세 미만 80~89: 80세 이상 90세 미만 90~: 90세 이상 필요한 동의 항목: 연령대	X
birthyear_needs_agreement	Boolean	사용자 동의 시 출생 연도 제공 가능 필요한 동의 항목: 출생 연도	X
birthyear	String	출생 연도(YYYY 형식) 필요한 동의 항목: 출생 연도	X
birthday_needs_agreement	Boolean	사용자 동의 시 생일 제공 가능 필요한 동의 항목: 생일	X
birthday	String	생일(MMDD 형식) 필요한 동의 항목: 생일	X
birthday_type	String	생일 타입 SOLAR(양력) 또는 LUNAR(음력) 필요한 동의 항목: 생일	X
gender_needs_agreement	Boolean	사용자 동의 시 성별 제공 가능 필요한 동의 항목: 성별	X
gender	String	성별 female: 여성 male: 남성 필요한 동의 항목: 성별	X
phone_number_needs_agreement	Boolean	사용자 동의 시 전화번호 제공 가능 필요한 동의 항목: 카카오계정(전화번호)	X
phone_number	String	카카오계정의 전화번호 국내 번호인 경우 +82 00-0000-0000 형식 해외 번호인 경우 자릿수와 '-'의 유무나 위치가 다를 수 있음 (참고: libphonenumber) 필요한 동의 항목: 카카오계정(전화번호)	X
ci_needs_agreement	Boolean	사용자 동의 시 CI 참고 가능 필요한 동의 항목: CI(연계정보)	X
ci	String	연계정보 필요한 동의 항목: CI(연계정보)	X
ci_authenticated_at	Datetime	CI 발급 시각, UTC* 필요한 동의 항목: CI(연계정보)	X

* 시간 정보는 UTC 기준으로, 한국 시간(KST)과 9시간 차이가 납니다. 시간 형식에 관한 자세한 정보는 RFC3339: Date and Time on the Internet를 참고합니다.