🪴

네이버 회원 정보 조회

부제

카테고리

네트워킹

세부 카테고리

소셜 API

Combine 카테고리

최종편집일

2022/07/16 15:21

작성중

1. 준비사항

•

애플리케이션 등록: 네이버 오픈 API로 개발하시려면 먼저 'Application-애플리케이션 등록' 메뉴에서 애플리케이션을 등록하셔야 합니다.[자세한 방법 보기] >

•

클라이언트 ID와 secret 확인: '내 애플리케이션'에서 등록한 애플리케이션을 선택하면 Client ID와 Client Secret 값을 확인할 수 있습니다.

•

API 권한 설정: '내 애플리케이션'의 'API 권한관리' 탭에서 사용하려는 API가 체크되어 있는지 확인합니다. 체크되어 있지 않을 경우 403 에러(API 권한 없음)가 발생하니 주의하시기 바랍니다.

2. API 기본 정보

Show All

메서드

인증

요청 URL

출력 포맷

설명

GET

Open

OAuth 2.0

https://openapi.naver.com/v1/nid/me

JSON

네이버 회원 프로필 조회

3. 요청 변수

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

4. 요청 헤더

Show All

요청 헤더명

설명

Authorization

Open

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

요청 헤더 예

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

5. 출력 결과

회원의 네이버아이디는 출력결과에 포함되지 않습니다. 대신 프로필조회 api 호출 결과에 포함되는 'id'라는 값을 이용해서 회원을 구분하시길 바랍니다. 'id'값은 각 애플리케이션마다 회원 별로 유니크한 값으로, 같은 네이버 회원이라도 네이버 로그인을 적용한 애플리케이션이 다르면 id값이 다른 점 유념하시길 바랍니다. 또한 가이드상에는 명시안되어 있지만 출력결과에 포함된 'enc_id'라는 값은 내부적으로 쓰는 값이므로 애플리케이션 개발에서 사용할 일이 없다고 보면되겠습니다.

Show All

필드

타입

필수 여부

설명

resultcode

Open

String

API 호출 결과 코드

message

Open

String

호출 결과 메시지

response/id

Open

String

동일인 식별 정보네이버 아이디마다 고유하게 발급되는 유니크한 일련번호 값(API 호출 결과로 네이버 아이디값은 제공하지 않으며, 대신 'id'라는 애플리케이션당 유니크한 일련번호값을 이용해서 자체적으로 회원정보를 구성하셔야 합니다.)

response/nickname

Open

String

사용자 별명(별명이 설정되어 있지 않으면 id*** 형태로 리턴됩니다.)

response/name

Open

String

사용자 이름

response/email

Open

String

사용자 메일 주소기본적으로 네이버 내정보에 등록되어 있는 '기본 이메일' 즉 네이버ID@naver.com 값이나, 사용자가 다른 외부메일로 변경했을 경우는 변경된 이메일 주소로 됩니다.

response/gender

Open

String

성별- F: 여성- M: 남성- U: 확인불가

response/age

Open

String

사용자 연령대

response/birthday

Open

String

사용자 생일(MM-DD 형식)

response/profile_image

Open

String

사용자 프로필 사진 URL

response/birthyear

Open

String

출생연도

response/mobile

Open

String

휴대전화번호

6. 에러 코드

공통 에러 코드는 여기를 참조하세요.

Show All

HTTP 코드

에러 코드

에러 메시지

조치 방안

401

24

Authentication failed / 인증에 실패했습니다.

Open

401

28

Authentication header not exists / OAuth 인증 헤더(authorization header)가 없습니다.

Open

403

403

Forbidden / 호출 권한이 없습니다.

Open

API 요청 헤더에 클라이언트 ID와 Secret 값을 정확히 전송했는지 확인해보시길 바랍니다.

404

404

Not Found / 검색 결과가 없습니다.

Open

500

500

Internal Server Error / 데이터베이스 오류입니다.

Open

서버 내부 에러가 발생하였습니다. 포럼에 올려주시면 신속히 조치하겠습니다.

응답 예시
{
  "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
복사