가이드 문서
Dashboard Sign InENAWS Marketplace

Error Codes

Asleep.AsleepErrorCode

  • version>SDK: 특정 SDK 버전 이전 사용가능, version<=SDK: 특정 SDK 버전 이상 사용가능
  • Android OS 버전 별로 Audio 입력 관련 SDK Error Code
    • Android OS 버전 9 이하: Audio 입력 기능을 사용하는 App이 2개 이상 실행이 될 경우 최초에 실행된 App에서만 Audio 입력 정상적으로 수신이 되고 이후에 실행된 App들은 Audio 입력 설정 시점에 내부 에러 처리되며, SDK에서는 "ERR_AUDIO"로 에러 코드 전달.
    • Android OS 버전 10 이상: Audio 입력 기능을 사용하는 App이 2개 이상 실행이 될 경우 가장 마지막에 실행된 App에서는 Audio 입력을 정상적으로 수신 되고 이전에 실행된 App에서는 "SILENCED" 상태로 "zero" 값을 수신하게 됨. SDK에서는 "zero" 음원을 수신하게 될 경우 "ERR_AUDIO_SILENCED" 에러 코드를 전달해 주며, 정상적으로 음원을 다시 수신하게 되면 "ERR_AUDIO_UNSILENCED" 에러 코드 전달.
ErrorCodeDescriptionHandlingVersion
ERR_SETUP_INCOMPLETE10000Setup process is not completed.SDK Stop3.1.0
ERR_UNABLE_ODA10001ODA is unavailable.SDK Stop3.1.0
ERR_UNKNOWN11000UnknownSDK Stop
ERR_UNINITIALIZED11001Uninitialized SDKSDK Stop
ERR_MIC_PERMISSION11002No mic permissionClient Handling
ERR_AUDIO11003Android Audio ErrorSDK Stop
ERR_INVALID_URL11004Invalid URL FormatSDK Stop
ERR_AUDIO_SILENCED11005Recording Audio SilencedSDK Handling
ERR_AUDIO_UNSILENCED11006Recording Audio UnsilencedSDK Handling
ERR_INSUFFICIENT_STORAGE11008저장 공간 부족(200MB 미만). 녹음 파일 저장을 사용할 때만 발생하며 측정을 시작하지 않습니다Client Handling3.3.0
ERR_INVALID_PARAMETER11009분석 구간의 시작 시각이 종료 시각보다 늦거나 같음. 또는 recordingPath / recordingType을 Completable 리스너 없이 전달함Client Handling3.3.0
ERR_COMMON_UNAUTHORIZED11401UnauthorizedSDK Stop
ERR_COMMON_EXPIRED11403Plan is expired | Rate limit exceeded | Quota exceededSDK Stop
ERR_COMMON_NOT_FOUND11404user not existSDK Stop
ERR_NETWORK11500HTTP 500 error | Network errorSDK Stop
ERR_TOKEN_ISSUE_FAILED12000토큰 발급 실패Client Handling3.3.0
ERR_TOKEN_REFRESH_FAILED12001토큰 갱신 실패Client Handling3.3.0
ERR_TOKEN_INVALID_CREDENTIALS12002잘못된 appId / appSecretClient Handling3.3.0
ERR_TOKEN_NETWORK_ERROR12003토큰 요청 중 네트워크 오류Client Handling3.3.0
ERR_PRODUCT_REGISTER_FAILED13000기기(Product) 등록 일시 실패. 네트워크 오류, 서버 오류(5xx), 요청 과다(429). SDK가 재시도한 뒤의 결과입니다Client Handling3.3.0
ERR_PRODUCT_REGISTER_REJECTED13400기기(Product) 등록 거부. 입력값 오류(400), 인증 실패(401), 등록 권한 없음(403). 다시 시도해도 결과가 같습니다Client Handling3.3.0
ERR_INIT_FAILED21000Failed to initAsleepConfig | Network error occurred.Client Handling
ERR_INIT_SERVER_ERROR21500internal server errorClient Handling
ERR_CREATE_FAILED22000Failed to create a session | Network error occurred.Client Handling
ERR_CREATE_CONFLICT22409The previous sleep session is not closed yet.SDK Stop
ERR_CREATE_SERVER_ERROR22500internal server errorSDK Stop
ERR_UPLOAD_FAILED23000Failed to upload | Network error occurred.SDK Handling
ERR_UPLOAD_BAD_REQUEST23400Invalid callback_url
or
audio format should be <sleep_session.sleep_sound_length> sec (16khz, 44.1khz, 48khz) (mp3, wav) under 10MB
or
cannot upload MELSPECTROGRAM file. only upload AUDIO file.		SDK Handling3.2.0
ERR_UPLOAD_UNAUTHORIZED23401invalid customer uuid | user_agent is emptySDK Handling3.2.0
ERR_UPLOAD_FORBIDDEN23403The session is already closed.SDK Stop3.2.0
ERR_UPLOAD_NOT_FOUND23404The session does not exist.SDK Stop3.2.0
ERR_UPLOAD_TOO_LARGE23413HTTP content length exceeded {size} bytes.SDK Handling3.2.0
ERR_UPLOAD_UNPROCESSABLE23422Invalid parameter | Invalid seq_num (seq_num starts from 0)SDK Handling3.2.0
ERR_UPLOAD_TRACKING_TERMINATED23499Unified all upload 4xx errors and deprecated individual upload error codesSDK Handling3.2.0
ERR_UPLOAD_SERVER_ERROR23500internal server errorSDK Handling
ERR_CLOSE_FAILED24000Failed to close a session | Network error occurred.Client Handling
ERR_CLOSE_UNAUTHORIZED24401Unauthorized | invalid customer uuidSDK Stop
ERR_CLOSE_FORBIDDEN24403The session is already closed.SDK Stop
ERR_CLOSE_BAD_REQUEST24400[WARNING] Invalid session end time. format(YYYY-MM-DDTHH:mm:ssz), must be less than session_start_timeSDK Stop
ERR_CLOSE_NOT_FOUND24404The session does not exist.SDK Stop
ERR_CLOSE_SERVER_ERROR24500internal server errorClient Handling
ERR_DELETE_FAILED25000Failed to delete a session | Network error occurred.Client Handling
ERR_DELETE_UNAUTHORIZED25401Invalid customer uuidClient Handling
ERR_DELETE_SERVER_ERROR25500internal server errorClient Handling
ERR_DELETE_USER_FAILED26000Failed to delete a customer uuid | Network error occurred.Client Handling
ERR_DELETE_USER_UNAUTHORIZED26401Invalid customer uuidClient Handling
ERR_DELETE_USER_SERVER_ERROR26500internal server errorClient Handling
ERR_SAVE_METADATA_FAILED27000사용자 메타데이터 저장 실패 (네트워크 · 서버 오류, userId 미설정, SDK 미초기화)Client Handling3.3.0
ERR_FETCH_METADATA_FAILED27100사용자 메타데이터 조회 실패 (네트워크 · 서버 오류, userId 미설정, SDK 미초기화)Client Handling3.3.0
ERR_SAVE_METADATA_VALIDATION27400서버가 메타데이터 값을 거부함(400). detail에 원인이 담깁니다Client Handling3.3.0
ERR_COMPLETE_TIMEOUT28000측정 종료 후 30초 안에 분석 완료를 확인하지 못함. 측정 실패가 아니며 세션은 정상 종료됩니다. 잠시 후 리포트를 조회하세요Client Handling3.3.0
ERR_REANALYZE_FAILED30000재분석 실패. 네트워크 오류, AsleepConfig에 userId 없음Client Handling3.3.0
ERR_REANALYZE_BAD_REQUEST30400잘못된 분석 시작 · 종료 시각Client Handling3.3.0
ERR_REANALYZE_UNAUTHORIZED30401재분석 인증 실패Client Handling3.3.0
ERR_REANALYZE_FORBIDDEN30403재분석 권한 없음Client Handling3.3.0
ERR_REANALYZE_NOT_FOUND30404세션을 찾을 수 없음Client Handling3.3.0
ERR_REANALYZE_CONFLICT30409지금은 재분석할 수 없음(이미 재분석 중 등). 반복해서 나오면 재분석이 불가능한 세션일 수 있으니 무한 재시도는 피하세요Client Handling3.3.0
ERR_REANALYZE_GONE30410데이터 보관 기간 만료Client Handling3.3.0
ERR_REANALYZE_UNPROCESSABLE30422아직 측정 중인 세션Client Handling3.3.0
ERR_REANALYZE_SERVER_ERROR30500재분석 서버 오류(5xx)Client Handling3.3.0
ERR_ANALYSE_FAILED31000Failed to analyse | Network error occurred.Client Handling
ERR_ANALYSE_UNAUTHORIZED31401UnauthorizedClient Handling
ERR_ANALYSE_NOT_FOUND31404Unable to find the sleep session of id {session_id}Client Handling
ERR_ANALYSE_SERVER_ERROR31500internal server errorClient Handling
ERR_REPORT_FAILED32000Failed to report | Network error occurred.Client Handling
ERR_REPORT_UNAUTHORIZED32401UnauthorizedClient Handling
ERR_REPORT_NOT_FOUND32404Unable to find the sleep session of id {session_id}Client Handling
ERR_REPORT_SERVER_ERROR32500internal server errorClient Handling
ERR_REPORTS_FAILED33000Failed to reports | Network error occurred.Client Handling
ERR_REPORTS_UNAUTHORIZED33401The API key is not provided.Client Handling
ERR_REPORTS_SERVER_ERROR33500internal server errorClient Handling
ERR_AVERAGE_REPORT_FAILED34000Failed to average report | Network error occurred.Client Handling
ERR_AVERAGE_REPORT_BAD_REQUEST34400The period should be less than or equal to 100 daysClient Handling
ERR_AVERAGE_REPORT_NOT_FOUND34404Unable to find the user of id {user_id}Client Handling
ERR_AVERAGE_REPORT_SERVER_ERROR34500internal server errorClient Handling

SDK Error 대응을 위한 정의

SDK 구간 동작에 대한 정의

  • Init (initAsleepConfig) : SDK 초기화 상태
  • Tracking (SleepTrackingManager): 수면 모니터링을 위한 Audio Recording 환경과 Server의 통신 프로토콜 관리
  • Report (Reports): 수면 모니터링 결과

Error Case Definition

  • SDK Stop: SDK 내부에서 종료 처리. SDK 내부적으로 종료 처리 되어서 새로 시작을 위해서는 SDK 재시작 필요. SDK 상태에 따라서 자체적으로 Session 종료 및 Audio Recording 기능에 대한 종료 처리됨. initAsleepConfig 요청 부터 새로 시작해야 SDK 활성화
  • SDK Handling: SDK 내부적으로 Error 업데이트 후 다음 동작을 수행. 에러 수신 후 종료 처리를 하고 싶으면 SDK 호출된 상태에 따라서 처리가 필요. SDK 종료 처리를 위해서는 Tracking 상태에서만 stopTracking 호출해 줘야 하고 다른 구간에서는 별도 처리 필요 없음.
  • Client Handling: Client에서 조치를 해줘야 하는 에러. 개발시 Error 확인 용도
  • Do not used: 현재 버전에서 사용되고 있지 않는 에러

Error Handling 분류

  • SDK 사용시 주로 나오는 Error Code는 붉은 색으로 표시. 취소선으로 선택된 Error Code는 나올 확률이 낮음.
  • Audio Error 관련 추가된 Error Code
  • ERR_AUDIO(11003): Audio Recording 설정 시점에 내부 에러에 의해 정상적으로 동작이 안되는 경우 "ERR_AUDIO" 에러 코드 전달
  • ERR_AUDIO_SILENCED(11005): Audio Recording 동작 중 측정 되는 음원이 "zero" 값으로 읽어오는 경우 "ERR_AUDIO_SILENCED" 에러 코드 전달.
  • ERR_AUDIO_UNSILENCED(11006): "ERR_AUDIO_SILENCED" 올려 준 후 Audio Recording 동작 중 측정 되는 음원이 정상적으로 회복 되었을 경우 "ERR_AUDIO_UNSILENCED" 에러 코드 전달.

Updated about 22 hours ago

Did this page help you?