페이지 이동경로
  • 문서>
  • 이용 안내>
  • FAQ

이용 안내

FAQ

이 문서는 자주 묻는 질문과 답변을 제공합니다.

공통

Q. 앱 등록 시 이름, 아이콘, 회사를 반드시 입력해야 하나요?

앱의 기본 정보에 해당하는 앱 이름, 앱 아이콘, 회사는 필수 입력 항목이며 실제 서비스 정보와 동일해야 합니다. 기본 정보가 올바르지 않은 경우, 사용자가 위변조된 앱으로 오해할 수 있습니다. 기본 정보를 참고합니다.

Q. 애플리케이션 소유자를 변경하고 싶어요.

앱 소유자 변경을 확인합니다.

앱 소유자를 확인할 수 없거나, 앱 소유자인 개발자 계정을 분실한 경우, 아래 증빙자료를 포함해 platform.developers@kakaocorp.com 메일로 앱 소유자 변경을 요청합니다.

  1. 서비스 및 앱 확인을 위한 앱 이름, REST API 키
  2. 앱을 소유 및 운영하는 사업자임을 증빙하는 서류
  3. 앱 소유자 변경을 요청하는 사용자의 재직증명서
    • 앱을 소유한 사업자가 발급한 재직증명서만 허용
  4. 앱 소유자로 변경할 개발자 계정 이메일
    • 앱을 소유한 사업자의 자체 이메일만 허용

Q. 앱 키 재발급 시 복구할 수 있나요?

앱 키 재발급 후 복구나 사용자 정보 이전이 불가능하므로, 불필요하게 앱 키를 재발급하거나 동일 서비스 정보로 앱을 새로 만들어 쓰지 않도록 주의해야 합니다.

애플리케이션(앱)마다 고유하게 부여되는 식별 정보인 앱 키는 재발급 시 기존 정보가 삭제되어 복구 불가능하니 주의가 필요합니다. 또한, 앱 키 재발급 시 기존 앱 키를 사용한 카카오 로그인 등 API 요청이 실패하게 됩니다. 앱 키 유출 사고 등 불가피한 경우를 제외하고는 운영 중인 서비스에서 앱 키를 재발급하지 않아야 합니다.

카카오디벨로퍼스에 새로운 앱을 등록하면 기존 앱과 이름이 같더라도 다른 서비스로 인식됩니다. 사용자 정보 중 식별자인 회원번호(user_id)는 앱 단위로 발급됩니다. 같은 사용자라도 앱마다 다른 값의 회원번호를 발급받으므로, 새로 만든 앱의 사용자가 기존 앱의 사용자인지 회원번호로 확인할 수 없습니다. 따라서 모든 사용자가 새로 만든 앱에 신규 가입을 해야 하는 문제가 발생할 수 있습니다. 이 경우, 사용자 정보 이전(마이그레이션, Migration)도 불가능합니다.

서비스 정보인 앱 이름, 아이콘, 회사명 변경이 필요하다면 앱 키 재발급 없이 [내 애플리케이션] > [일반] > [기본 정보]에서 수정합니다. 기본 정보에 대한 자세한 안내는 기본 정보의 용도를 참고합니다.

기존에 사용하던 앱의 관리 계정을 모두 분실해 정보 확인이나 수정이 불가능한 경우에는 Q. 애플리케이션 소유자를 변경하고 싶어요. 항목을 참고해 소유자를 변경하여야 합니다.

Q. "API limit has been exceeded." 에러가 발생합니다.

카카오 오픈 API는 매달 정해진 사용량만큼 무료로 제공됩니다. 사용량 제한(쿼터)을 넘어서면 "API limit has been exceeded." 에러가 발생하고 더 이상 해당 API를 사용할 수 없습니다. API마다 정해진 사용량 제한을 확인하려면 쿼터를 참고합니다.

만약 사용량 제한을 늘리고 싶다면 데브톡에 대상 앱과 사유를 담아 협의 또는 제휴를 요청합니다. 지도/로컬 API에 대한 쿼터 상향이 필요한 경우에는 공지사항을 우선 확인합니다. 카카오는 요청 내용을 검토하고 제휴를 체결하거나 임시로 사용량 제한 범위를 조절할 수 있습니다.

Q. 이미 운영 중인 실제 서비스에 영향을 주지 않고 테스트할 수 있나요?

테스트 앱으로 운영 중인 서비스에 영향을 주지 않고 테스트할 수 있습니다. 테스트 앱 사용 방법은 애플리케이션 > 테스트 앱을 참고합니다.

Kakao SDK for Android

Q. "android keyhash mismatched!" 에러가 발생합니다.

앱에서 사용한 키 해시값이 플랫폼에 등록한 키 해시값과 달라 발생하는 에러입니다.

권장 앱 게시 방법인 안드로이드 앱 번들(Android App Bundles)을 사용하는 경우, Google Play Console에서 릴리즈 키 해시 구하기 방법으로 얻은 값을 플랫폼에 등록해야 합니다. 앱 번들 방식은 앱에 업로드 키로 서명한 후 Play Console에 업로드 하면 Google Play가 APK 생성 및 앱 서명을 직접 하는 게시 방법입니다. 따라서 이 경우, 터미널이나 Android SDK에서 얻은 릴리즈 키 해시 값을 사용할 수 없습니다.

Kakao SDK for iOS

Q. Friend 모듈 설치 및 사용 시 오류가 발생합니다.

iOS SDK가 제공하는 모듈 중, Friend 모듈의 경우 리소스 번들 파일을 포함합니다. Cocoapods를 통해 2.15.0 버전 이하의 iOS SDK를 전체 설치하거나 피커 모듈을 포함해 설치할 경우, Podfile 하단에 아래 내용을 추가해야 합니다.

post_install do |installer|
  installer.pods_project.targets.each do |target|
      target.build_configurations.each do |config|
        config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
      end
  end
end
이용 안내> FAQ