사이드 메뉴
커뮤니케이션
API 제공
어드민 API
에러 코드
이 문서는 카카오 또는 공동체 서비스가 카카오 소셜 구현 시 발생할 수 있는 에러와 그 해결 방법을 안내합니다. 공통 에러 코드는 오픈 문서를 참고합니다.
JavaScript SDK(Kakao SDK for JavaScript)를 사용한 카카오 소셜 구현 시 발생할 수 있는 에러와 그 해결 방법을 안내합니다. 이 문서에 포함되어 있지 않은 에러는 에러 코드와 에러 코드: KAPI에서 확인할 수 있습니다.
JavaScript SDK를 사용해 친구 피커, 채팅방 피커, 탭 피커 호출 시 발생할 수 있는 에러 정보입니다.
| 에러 코드 | 설명 |
|---|---|
| -204 | 조회된 친구 목록이 없을 경우 해결 방법: 친구 추가 후 다시 시도 |
| -400 | 잘못된 파라미터를 사용한 경우 해결 방법: 잘못된 파라미터를 수정 후 다시 시도 |
| -403 | 지원하지 않는 브라우저에서 요청한 경우 해결 방법: 지원하는 웹 브라우저 확인 후, 지원되는 브라우저에서 다시 시도 |
사용자가 필요한 동의항목에 동의하지 않은 경우 아래와 같이 -402 에러가 반환됩니다. 이 경우 동의항목 추가 동의 요청을 호출해 사용자로부터 필요한 동의항목에 대해 동의받아야 합니다.
{"msg": "insufficient scopes.","code": -402,"api_type": "FRIENDS_SDK","required_scopes": ["friends"],"allowed_scopes": ["profile"]}
Partner Android SDK(Kakao Partner SDK for Android)를 사용한 카카오 소셜 구현 시 발생할 수 있는 에러와 그 해결 방법을 안내합니다. 이 문서에 포함되어 있지 않은 에러는 에러 코드와 에러 코드: KAPI에서 확인할 수 있습니다.
Android SDK를 사용해 친구 피커, 채팅방 피커, 탭 피커 호출 시 발생할 수 있는 에러 정보입니다.
| 에러 | 설명 |
|---|---|
| BadParameter | minPickableCount 값을 1보다 작은 수로 설정한 경우 해결 방법: minPickableCount 값을 최소값인 1이나 1보다 큰 수로 설정 |
| BadParameter | maxPickableCount 값을 100보다 큰 수로 설정한 경우 해결 방법: maxPickableCount 값을 최대값인 100이나 100 보다 작은 수로 설정 |
| BadParameter | minPickableCount 값을 maxPickableCount 보다 큰 값을 설정한 경우 해결 방법: minPickableCount 값을 maxPickableCount 값보다 작거나 같게 설정 |
| BadParameter | chatFilters에 OPEN을 지정한 경우 또는 DIRECT나 MULTI를 REGULAR 없이 단독으로 지정한 경우 해결 방법: 채팅방 멤버 목록에는 오픈채팅방이 포함될 수 없으므로 chatFilters에 REGULAR을 지정하거나, DIRECT나 MULTI 지정 시 REGULAR와 함께 지정(예: listOf(PickerChatFilter.DIRECT, REGULAR)) |
| BadParameter | DisableSelectReason.CUSTOM 지정 시 uuids나 message 값을 입력하지 않은 경우 해결 방법: 불가 사유를 표시할 사용자를 uuids로 전달하고, 불가 사유를 message로 전달 |
| Cancelled | 사용자가 피커에서 [취소] 버튼을 누른 경우 |
Partner iOS SDK(Kakao Partner SDK for iOS)를 사용한 카카오 소셜 구현 시 발생할 수 있는 에러와 그 해결 방법을 안내합니다. 이 문서에 포함되어 있지 않은 에러는 에러 코드와 에러 코드: KAPI에서 확인할 수 있습니다.
Partner iOS SDK를 사용해 친구 피커, 채팅방 피커, 탭 피커 호출 시 발생할 수 있는 에러 정보는 Android SDK 피커 관련 에러와 동일합니다.