이 문서는 Legacy JavaScript SDK(Kakao SDK for JavaScript v1)를 사용한 카카오톡 소셜 API 구현 방법을 안내합니다.

현재 로그인한 사용자의 카카오계정에 연결된 카카오톡 프로필 정보를 받는 기능입니다.

사용자 카카오계정에 연결된 카카오톡이 없다면 에러 응답을 받습니다.

url 값에 /v1/api/talk/profile를 지정하여 Kakao.API.request() 함수를 호출합니다.

Kakao.API.request({
  url: '/v1/api/talk/profile',
  success: function (response) {
    console.log(response)
  },
  fail: function (error) {
    console.log(error)
  },
})

요청 성공 시 JSON 객체로 카카오톡 프로필 정보를 받습니다. 요청 성공 시 응답 정보는 REST API를 참고합니다.

사용자가 카카오톡 친구를 선택할 수 있는 피커를 호출합니다. 선택 유형에 따라 호출해야 할 함수가 다르므로, 서비스의 필요에 맞는 함수를 선택해 사용합니다.

Legacy JavaScript SDK를 사용해 피커를 호출할 경우, 서비스 UI/UX에 맞춰 피커 화면으로 자연스럽게 이동할 수 있도록 두 가지 사용 방식을 제공합니다.

• 팝업 방식
  • 피커가 팝업창으로 나타나는 형태
  • 선택한 친구 정보를 success, fail, always 콜백 함수로 전달
• 리다이렉트(Redirect) 방식
  • 현재 창에서 피커로 이동하는 형태
  • 선택한 친구 정보를 URL 인코딩하여 서비스 서버의 returnUrl로 리다이렉트(HTTP 302 Redirect)하여 쿼리 문자열(Query string)로 전달
  • 앱 관리 페이지의 [앱] > [플랫폼 키] > [JavaScript 키] > [JavaScript SDK 도메인]에 returnUrl의 도메인 등록 필수

피커의 구성 요소, 언어는 파라미터를 사용해 선택적으로 지정할 수 있습니다. 아래 표를 참고합니다.

// 팝업 방식
Kakao.Picker.selectFriends({
  title: '친구 선택',
  maxPickableCount: 10,
  minPickableCount: 1,
  success: function (response) {
    console.log(response)
  },
  fail: function (error) {
    console.log(error)
  },
})

// 리다이렉트 방식
// 성공: ${returnUrl}?selected=${SelectedUsers}
// 실패: ${returnUrl}?error=${Error}
Kakao.Picker.selectFriends({
  returnUrl: 'https://developers.kakao.com', // 필수
  title: '친구 선택',
  maxPickableCount: 10,
  minPickableCount: 1,
})

사용자가 피커 화면에서 친구 선택을 완료하면 SelectedUsers 객체가 반환됩니다. 해당 객체는 선택된 각 친구의 정보를 SelectedUser 객체의 배열로 포함합니다. 요청에 실패했거나 문제가 발생한 경우 에러 코드에서 원인을 확인합니다.

현재 로그인한 사용자의 카카오계정에 연결된 카카오톡의 친구 정보를 받아 옵니다.

정렬 순서, 한 페이지에 가져올 친구 수 등 파라미터를 선택적으로 사용하여 요청할 수 있습니다.

url 값으로 /v1/api/talk/friends를 지정하여 Kakao.API.request() 함수를 호출합니다.

Kakao.API.request({
  url: '/v1/api/talk/friends',
  success: function (response) {
    console.log(response)
  },
  fail: function (error) {
    console.log(error)
  },
})

요청 성공 시 JSON 객체로 카카오톡 친구 정보를 받습니다. 사용자 카카오계정에 연결된 카카오톡이 없다면 에러 응답을 받습니다.

응답 중 각 친구의 uuid 값은 메시지 발송 API 요청 시 사용하는 수신자 정보로, 메시지 발송 전 친구 목록을 먼저 받아와야 해당 값을 구할 수 있습니다. 자세한 응답 정보는 REST API를 참고합니다.

카카오톡 친구 수가 요청 시 limit보다 많다면 결과가 페이지로 나뉩니다. 이런 경우, 직접 파라미터를 하나하나 지정하지 않고도 응답에 포함된 after_url을 사용해 친구 목록 받기를 요청하면 다음 페이지의 친구 목록을 받아올 수 있습니다.

• Legacy JavaScript SDK 다운로드
• Legacy JavaScript SDK 레퍼런스