페이지 이동경로
  • 문서>
  • 시작하기>
  • FAQ

시작하기

FAQ

이 문서는 처음 사용자를 위한 자주 묻는 질문과 답변을 제공합니다.

공통

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

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

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

애플리케이션(앱) 소유자(Owner) 변경은 서비스에 치명적인 영향을 미칠 수 있습니다. 때문에 다음 절차를 거쳐 꼭 필요한 경우에 한해 앱 소유자 변경이 가능합니다.

  • 데브톡에서 통해 앱 소유자 변경 공지사항을 확인하고 문의 게시물을 등록합니다.
  • 현재 소유자 계정이 무엇인지 파악 후, 해당 계정에 접근할 수 있는 상태인지 확인합니다.
  • 현재 소유자 계정이 담당자 퇴사 등 이유로 접근할 수 없는 상태라면, 앱 및 서비스의 실제 소유자임을 확인하기 위한 자료를 요청합니다. 확인 자료는 사업자등록증, 현재 서비스에 적용된 앱 키 값, 서비스 도메인 등이며 데브톡 메시지를 통해 요청을 주고 받습니다.
  • 서류를 통해 실제 소유자임을 확인한 뒤, 소유자 변경 처리가 이뤄집니다.

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

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

앱은 서비스 정보를 카카오 플랫폼에 등록한 것이므로, 앱을 새로 등록하면 카카오디벨로퍼스(Kakao Developers, 이하 개발자 웹사이트)에 새로운 앱을 등록하면 기존 앱과 이름이 같더라도 다른 서비스로 인식됩니다. 따라서 기존 사용자가 로그인 시도 시 다시 카카오 로그인 및 회원 가입을 하게 되며, 사용자 정보 이전(마이그레이션, migration)도 불가능합니다.

또한 사용자 정보 중 회원 ID 역할을 하는 회원번호(user_id)는 앱 단위로 발급되므로, 새로 만든 앱에서는 같은 사용자라도 기존 회원 정보와 다른 값을 발급 받아서 동일 사용자인지 확인할 수 없게 됩니다. 때문에 앱을 새로 만들어 사용하면 기존 사용자들도 신규 가입을 해야 하는 상황이 벌어집니다.

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

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

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

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

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

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

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. [Legacy] 웹뷰 등 취소 후 다시 로그인 시도시 "The operation is cancelled."가 반복적으로 나오는 현상이 생깁니다.

openWithCompletionHandler 호출 전 [[KOSession sharedSession] close]로 오래된 세션을 닫는 로직이 빠지지 않았는지 확인합니다. 로그인 예제를 참고합니다.

Q. [Legacy] 로그인 시도시 '+[NSBundle ko_appKey]: unrecognized selector sent to class 0x111111'의 에러가 발생하면서 앱이 강제 종료(crash)됩니다.

[Other Linker Flags]에 -ObjC 옵션을 추가했는지 확인합니다. 자세한 내용은 Framework 설정을 참고합니다.