Error Codes

SDK를 사용하면서 발생할 수 있는 에러 코드 목록과 해결 방안을 안내합니다. API 호출이 실패하면 반환되는 응답 객체에 포함된 에러 코드를 확인하여 원인을 파악하고 문제를 해결할 수 있습니다.

공통 에러 포맷

API 호출 실패 시, 에러는 일반적으로 다음과 같은 JSON 형식의 응답 본문에 포함됩니다. errorCode 값을 아래 표에서 찾아 문제를 해결하세요.

{
  "status": "ERROR",
  "data": { "errorCode": "N005", "errorMessage": "DATA_PARSE_FAILED" },
  "sdkVersion": "0.0.0+00000",
  "customData": null
}

아래 표에서 발생한 errorCode를 찾아 원인과 해결 방법을 확인하세요.

에러 코드	설명	해결 방안 / 조치
`C001`	유효하지 않은 파라미터 입니다.	올바른 `goodsId`와 `suid`를 사용하고 있는지 확인하세요.
`C002`	필수 파라미터가 누락되거나 형식이 잘못되었습니다.	SDK 함수 호출 시 전달하는 파라미터 값과 타입을 API 문서와 비교하여 수정하세요.
`C003`	테스트 초기 설정 정보(예: UI 테마, 문구) 로드에 실패했습니다.	SDK 초기화 시점에 해당 파라미터를 정확히 전달했는지 확인하세요.

에러 코드	설명	해결 방안 / 조치
`N001`	기기의 네트워크 연결이 끊겼거나 불안정합니다.	사용자에게 네트워크 연결 상태를 확인하라는 메시지를 보여주거나, 재시도 로직을 구현하세요.
`N002`	서버로부터 응답을 받는 데 시간이 너무 오래 걸렸습니다.	네트워크 상태가 양호하다면 잠시 후 다시 시도하세요. 문제가 지속되면 저희 기술 지원팀에 알려주세요.
`N003`	서버 내부에서 예기치 않은 오류가 발생했습니다.	이 에러는 저희 쪽 문제입니다. 잠시 후 다시 시도해 주시고, 문제가 계속되면 기술 지원팀에 알려주세요.
`N004`	해당 사용자에게 제공할 테스트 문항이 없습니다.	알 수 없는 이유로 인해 해당 사용자에게 더 이상 테스트가 제공되지 않는 상황입니다.
`N005`	서버에서 받은 데이터 형식이 잘못되어 파싱에 실패했습니다.	서버 응답 포맷이 기존과 상이하여 나타나는 에러입니다. 기술 지원팀에 알려주세요.
`N006`	SDK가 지원하지 않는 API를 호출했습니다.	SDK 버전을 확인하시고 필요하다면 업그레이드해주세요.

에러 코드	설명	해결 방안 / 조치
`S001`	세션 유지 시간(예: 30분)이 만료되었습니다.	에러가 아닌 정보성 코드입니다. 테스트 제한시간 30분을 초과하였습니다.
`S002`	사용자의 테스트 답변 제출에 실패했습니다.	테스트 답변을 제출하는 과정에서 문제가 발생하였습니다. 문제가 계속되면 기술 지원팀에 알려주세요.
`S004`	세션 유지에 실패했습니다.	SDK 내부 세션을 유지하는데 실패했습니다. 문제가 지속되면 기술 지원팀에 알려주세요.

에러 코드	설명	해결 방안 / 조치
`I001`	사용자가 '테스트 종료' 버튼을 눌러 테스트를 중단했습니다.	사용자의 정상적인 이탈 시나리오입니다. 별도의 에러 메시지를 표시할 필요가 없습니다. 이전 화면으로 안전하게 복귀시키세요.
`I002`	외부 요인으로 인해('quit') 강제 종료되었습니다.	Host 앱의 코드 로직에 의해 테스트가 종료될 때 발생하는 코드입니다. 사용자에게 에러를 표시하지 않고, 앱의 흐름에 맞게 다음 동작을 처리하세요.

에러 코드	설명	해결 방안 / 조치
`E999`	SDK 내부에서 발생한 예기치 않은 오류입니다.	에러 발생 상황과 함께 저희 기술 지원팀에 문의해 주시면 빠르게 도와드리겠습니다.

만약 위 목록에 없는 에러가 발생하거나 문제 해결에 어려움이 있다면, 주저하지 마시고 기술 지원팀에 문의해 주세요.