Search
🪴

네이버 회원 정보 조회

1. 준비사항

애플리케이션 등록: 네이버 오픈 API로 개발하시려면 먼저 'Application-애플리케이션 등록' 메뉴에서 애플리케이션을 등록하셔야 합니다.[자세한 방법 보기] >
클라이언트 ID와 secret 확인: '내 애플리케이션'에서 등록한 애플리케이션을 선택하면 Client ID와 Client Secret 값을 확인할 수 있습니다.
API 권한 설정: '내 애플리케이션'의 'API 권한관리' 탭에서 사용하려는 API가 체크되어 있는지 확인합니다. 체크되어 있지 않을 경우 403 에러(API 권한 없음)가 발생하니 주의하시기 바랍니다.

2. API 기본 정보

메서드
인증
요청 URL
출력 포맷
설명

3. 요청 변수

요청 변수는 별도로 없으며, 요청 URL로 호출할 때 아래와 같이 요청 헤더에 접근 토큰 값을 전달하면 됩니다.

4. 요청 헤더

요청 헤더명
설명
접근 토큰(access token)을 전달하는 헤더다음과 같은 형식으로 헤더 값에 접근 토큰(access token)을 포함합니다. 토큰 타입은 "Bearer"로 값이 고정돼 있습니다. Authorization: {토큰 타입] {접근 토큰]

요청 헤더 예

Authorization: Bearer AAAAOLtP40eH6P5S4Z4FpFl77n3FD5I+W3ost3oDZq/nbcS+7MAYXwXbT3Y7Ib3dnvcqHkcK0e5/rw6ajF7S/QlJAgUukpp1OGkG0vzi16hcRNYX6RcQ6kPxB0oAvqfUPJiJw==
Swift
복사

5. 출력 결과

회원의 네이버아이디는 출력결과에 포함되지 않습니다. 대신 프로필조회 api 호출 결과에 포함되는 'id'라는 값을 이용해서 회원을 구분하시길 바랍니다. 'id'값은 각 애플리케이션마다 회원 별로 유니크한 값으로, 같은 네이버 회원이라도 네이버 로그인을 적용한 애플리케이션이 다르면 id값이 다른 점 유념하시길 바랍니다. 또한 가이드상에는 명시안되어 있지만 출력결과에 포함된 'enc_id'라는 값은 내부적으로 쓰는 값이므로 애플리케이션 개발에서 사용할 일이 없다고 보면되겠습니다.
필드
타입
필수 여부
설명
String
Y
API 호출 결과 코드
String
Y
호출 결과 메시지
String
Y
동일인 식별 정보네이버 아이디마다 고유하게 발급되는 유니크한 일련번호 값(API 호출 결과로 네이버 아이디값은 제공하지 않으며, 대신 'id'라는 애플리케이션당 유니크한 일련번호값을 이용해서 자체적으로 회원정보를 구성하셔야 합니다.)
String
Y
사용자 별명(별명이 설정되어 있지 않으면 id*** 형태로 리턴됩니다.)
String
Y
사용자 이름
String
Y
사용자 메일 주소기본적으로 네이버 내정보에 등록되어 있는 '기본 이메일' 즉 네이버ID@naver.com 값이나, 사용자가 다른 외부메일로 변경했을 경우는 변경된 이메일 주소로 됩니다.
String
Y
성별- F: 여성- M: 남성- U: 확인불가
String
Y
사용자 연령대
String
Y
사용자 생일(MM-DD 형식)
String
Y
사용자 프로필 사진 URL
String
Y
출생연도
String
Y
휴대전화번호

6. 에러 코드

공통 에러 코드는 여기를 참조하세요.
HTTP 코드
에러 코드
에러 메시지
조치 방안
403
403
API 요청 헤더에 클라이언트 ID와 Secret 값을 정확히 전송했는지 확인해보시길 바랍니다.
500
500
서버 내부 에러가 발생하였습니다. 포럼에 올려주시면 신속히 조치하겠습니다.
응답 예시 { "resultcode": "00", "message": "success", "response": { "email": "openapi@naver.com", "nickname": "OpenAPI", "profile_image": "https://ssl.pstatic.net/static/pwe/address/nodata_33x33.gif", "age": "40-49", "gender": "F", "id": "32742776", "name": "오픈 API", "birthday": "10-01", "birthyear": "1900", "mobile": "010-0000-0000" } }
Swift
복사