가이드 문서
ENDashboardHomepage

Error Codes

Suggest Edits

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_UNKNOWN11000Unknownv2.1.2>SDK
ERR_UNINITIALIZED11001Uninitialized SDKSDK Stop
ERR_MIC_PERMISSION11002No mic permissionClient Handling
ERR_AUDIO11003Android Audio ErrorSDK Stopv2.2.0<=SDK
ERR_INVALID_URL11004Invalid URL FormatSDK Stop
ERR_AUDIO_SILENCED11005Recording Audio SilencedSDK Handlingv2.2.0<=SDK
ERR_AUDIO_UNSILENCED11006Recording Audio UnsilencedSDK Handlingv2.2.0<=SDK
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 Stopv2.1.2>SDK
ERR_INIT_FAILED21000Failed to initAsleepConfig | Network error occurred.Client Handlingv2.1.2<=SDK
ERR_INIT_SERVER_ERROR21500internal server errorClient Handlingv2.1.2<=SDK
ERR_CREATE_FAILED22000Failed to create a session | Network error occurred.Client Handlingv2.1.2<=SDK
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_UNAUTHORIZED23401invalid customer uuid | user_agent is emptySDK Handling
ERR_UPLOAD_FORBIDDEN23403The session is already closed.SDK Stop
ERR_UPLOAD_NOT_FOUND23404The session does not exist.SDK Stop
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 Handling
ERR_UPLOAD_TOO_LARGE23413HTTP content length exceeded {size} bytes.SDK Handling
ERR_UPLOAD_UNPROCESSABLE23422Invalid parameter | Invalid seq_num (seq_num starts from 0)SDK Handling
ERR_UPLOAD_SERVER_ERROR23500internal server errorSDK Handling
ERR_CLOSE_FAILED24000Failed to close a session | Network error occurred.Client Handlingv2.1.2<=SDK
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 Handlingv2.1.2<=SDK
ERR_DELETE_UNAUTHORIZED25401Invalid customer uuidClient Handling
ERR_DELETE_SERVER_ERROR25500internal server errorClient Handlingv2.1.2<=SDK
ERR_DELETE_USER_FAILED26000Failed to delete a customer uuid | Network error occurred.Client Handlingv2.1.2<=SDK
ERR_DELETE_USER_UNAUTHORIZED26401Invalid customer uuidClient Handling
ERR_DELETE_USER_SERVER_ERROR26500internal server errorClient Handlingv2.1.2<=SDK
ERR_ANALYSE_FAILED31000Failed to analyse | Network error occurred.Client Handlingv2.1.2<=SDK
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 Handlingv2.1.2<=SDK
ERR_REPORT_FAILED32000Failed to report | Network error occurred.Client Handlingv2.1.2<=SDK
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 Handlingv2.1.2<=SDK
ERR_REPORTS_FAILED33000Failed to reports | Network error occurred.Client Handlingv2.1.2<=SDK
ERR_REPORTS_UNAUTHORIZED33401The API key is not provided.Client Handling
ERR_REPORTS_SERVER_ERROR33500internal server errorClient Handlingv2.1.2<=SDK
ERR_AVERAGE_REPORT_FAILED34000Failed to average report | Network error occurred.Client Handlingv2.3.0<=SDK
ERR_AVERAGE_REPORT_BAD_REQUEST34400The period should be less than or equal to 100 daysClient Handlingv2.3.0<=SDK
ERR_AVERAGE_REPORT_NOT_FOUND34404Unable to find the user of id {user_id}Client Handlingv2.3.0<=SDK
ERR_AVERAGE_REPORT_SERVER_ERROR34500internal server errorClient Handlingv2.3.0<=SDK

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 분류

v2.2.0<=SDK

  • 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" 에러 코드 전달.

v2.1.2=SDK

v2.1.2>SDK

SDK 사용시 주로 나오는 Error Code는 붉은 색으로 표시.
취소선으로 선택된 Error Code는 나올 확률이 낮음.
파란색 에러코드는 새로 추가된 Error Code 정보.

Updated 7 months ago