문제 해결

이 문서는 피커 이용 중 발생할 수 있는 주요 에러와 해결 방법을 안내합니다. 이 외 카카오톡 소셜 API 호출 시 발생할 수 있는 에러 정보는 응답 코드에서 확인할 수 있습니다.

공통

피커를 통해 제공받은 친구 정보의 수가 선택한 친구 수보다 적은 경우

멀티 피커에서 사용자가 선택한 친구의 수가 서비스에 제공되는 친구 정보의 수와 다를 수 있습니다. 이 경우, 사용자의 사용성을 고려하여 사용자가 선택한 친구 수 보다 적은 수의 친구 정보가 전달되었다는 사실을 알려야 합니다.

다음은 선택한 친구 수와 응답의 친구가 다른 경우의 예시 상황입니다.

1. A가 친구 피커에서 B 선택
2. 친구 피커에서 정보 요청이 완료되기 전, B가 앱과 연결을 끊음
3. A가 친구 피커에서 [확인]을 눌러 친구 선택 완료
4. 친구 피커에서 선택된 B는 선택된 친구 수에는 포함되지만, 정보를 요청한 시점에는 앱과의 연결이 끊겨 선택된 친구 정보 목록에 포함되지 않음

JavaScript

JavaScript SDK를 통해 피커 사용 중 에러가 발생할 경우, 공통 응답 포맷에 따라 code와 msg가 반환됩니다.

코드	설명
-204	조회된 친구 목록이 없을 경우 해결 방법: 친구 추가 후 다시 시도
-400	잘못된 파라미터를 사용한 경우 해결 방법: 잘못된 파라미터를 수정 후 다시 시도
-403	지원하지 않는 브라우저에서 요청한 경우 해결 방법: 지원하는 웹 브라우저 확인 후, 지원되는 브라우저에서 다시 시도

참고: 추가 항목 동의 받기

사용자가 필요한 동의항목에 동의하지 않은 경우 아래와 같이 -402 에러가 반환됩니다. 이 경우 추가 항목 동의 받기를 호출하여 사용자로부터 필요한 동의항목에 대해 동의받아야 합니다.

{
    "msg": "insufficient scopes.",
    "code": -402,
    "api_type": "FRIENDS",
    "required_scopes": [
        "friends"
    ],
    "allowed_scopes": [
        "talk_message",
        "profile"
    ]
}

Android

Android SDK를 통해 피커 사용 시 발생할 수 있는 에러 정보입니다.

에러	설명
BadParameter	minPickableCount 값을 1보다 작은 수로 설정한 경우 해결 방법: minPickableCount 값을 최소값인 1이나 1보다 큰 수로 설정
BadParameter	maxPickableCount 값을 100보다 큰 수로 설정한 경우 해결 방법: maxPickableCount 값을 최대값인 100이나 100 보다 작은 수로 설정
BadParameter	minPickableCount 값을 maxPickableCount 보다 큰 값을 설정한 경우 해결 방법: minPickableCount 값을 maxPickableCount 값보다 작거나 같게 설정
Cancelled	사용자가 피커에서 [취소] 버튼을 누른 경우

iOS

iOS SDK를 통해 피커 사용 시 발생할 수 있는 에러는 Android SDK와 동일하므로, Android를 참고합니다.

Flutter

Flutter SDK를 통해 피커 사용 시 발생할 수 있는 에러는 JavaScript SDK와 동일하므로, JavaScript를 참고합니다.