공통 | Error
HTTP의 응답 코드로 확인할 수 없는 에러는 에러 코드를 통해 에러 발생 원인을 분석할 수 있습니다.
에러 메시지 구조
API 실행 중 에러가 발생했을 때 아래와 같은 구조로 에러 값을 반환합니다.
Error
Object
발생한 에러에 대한 상세 설명을 제공하는 오브젝트
└ Message
String
해당 에러에 대한 간략한 설명
└ Code
Enum
에러 원인을 상세하게 확인하게 위한 Error Code 값
가전 API 에러 코드
규칙
가전 API의 에러 코드는 클라이언트 에러와 서버 에러로 구분됩니다. LG ThinQ 플랫폼에서 사용하는 ThinQ Connect API의 에러코드와 동일합니다.
클라이언트에게 에러 원인을 알려주기 위해 사용됩니다
서버 문제로 발생하는 에러를 나타내기 위해 사용됩니다.
1000
클라이언트 에러
11xx
파라미터
12xx
리소스
13xx
권한
2000
서버에러
전체 에러 코드 목록
0000
Unknown error
정의 되지 않은 에러 (분석해야 하는 에러)
500
1000
Bad request
잘못된 요청
400
1101
Missing parameters
필수 입력 항목이 누락됨
400
1102
Unacceptable parameters
허용하지 않는 파라미터들이 입력됨
400
1103
Invalid token
토큰 문법이 잘못됨
400
1104
Invalid message id
메시지 ID의 문법이 잘못됨
400
1201
Not registered admin
등록된 관리자가 없음
404
1202
Not registered user
등록된 사용자가 없음
404
1203
Not registered service
등록된 서비스가 없음
404
1204
Not subscribed event
구독된 이벤트가 없음
404
1205
Not registered device
등록된 디바이스가 없음
404
1206
Not subscribed push
구독된 푸쉬가 없음
404
1207
Already subscribed push
등록된 푸쉬가 있음 (동일한 푸쉬가 이미 존재함)
404
1208
Not registered service by admin
관리자가 관리하는 서비스가 아님
404
1209
Not registered user in service
서비스를 사용하는 사용자가 아님
404
1210
Not registered device in service
서비스가 허용하는 디바이스 아님
404
1211
Not registered device by user
사용자가 등록한 디바이스가 아님
404
1212
Not owned device
사용자가 가지고 있지 않은 디바이스
404
1213
Not registered device
등록된 디바이스가 없음
404
1214
Not subscribable device
이벤트 구독을 허용하지 않는 디바이스
404
1216
Incorrect Header
헤더에 포함된 값이 올바르지 않음
400
1217
Already device deleted
해당 디바이스가 삭제되었음
400
1218
Invalid token
유효하지 않은 토큰임
400
1219
Not supported model
지원하지 않는 제품 모델임
406
1220
Not supported feature
해당 제품 모델에서는 지원하지 않는 기능임
406
1221
Not supported product
지원하지 않는 임 (해당 서비스 키에 허용된 디바이스 타입이 아님) 디바이스 타입
406
1222
Not connected device
디바이스가 네트워크에 연결되어 있지 않음
416
1223
Invalid status device
전달된 디바이스 상태 값이 유효하지 않음
416
1224
Invalid device Id
허용되지 않은 디바이스 Id
404
1301
Invalid service key
유효하지 않은 서비스 키
401
1302
Not found token
만료된 토큰
401
1303
Not found user
토큰이 발급되지 않은 사용자
401
1304
Not acceptable terms
서비스 약관 미동의
401
1305
Not allowed api
허용되지 않은 API
401
1306
Exceeded API calls API
호출 횟수 초과
401
1307
Not supported country
지원하지 않는 국가
401
1308
No control autdority
디바이스 제어권 없음 (ThinQ App에서 사용중)
401
1310
Not supported domain
제공되지 않은 도메인을 사용한 경우
401
1311
Bad request format
요청 포맷이 잘못된 경우
401
1312
Exceeded number of event subscription
해당 서비스 키에 설정된 이벤트 등록 기기 수의 제한을 넘음
400
2000
Internal server error
내부 서버 에러
500
2101
Not supported model
지원하지 않은 가전 모델
503
2201
Not provided feature
지원하는 기능이 아님
503
2202
Not supported product
지원하는 제품군이 아님
400
2203
Not existent modelJSON
ModelJSON이 없음
503
2205
Invalid device status
디바이스 상태 정보가 정상적으로 전송되지 않았거나, 전송된 정보가 정상적으로 파싱되지 않았을 경우
400
2207
Invalid command error
유효하지 않은 제어 명령일 때 (제어 명령에 정의되지 않은 resource, property 가 포함된 경우)
400
2208
Fail device control
디바이스 제어 실패
400
2209
Device response delay
디바이스 응답 지연
400
2210
Retry request
상태조회 재요청 필요
400
2212
Syncing ModelJSON
싱크 중 (에어솔루션 제품)
412
2213
Retry after deleting device
ModelJSON 싱크 실패. 디바이스 삭제 후 재시도 바람 (에어솔루션 제품)
412
2214
Fail Request
요청 실패
400
2301
Command not supported in REMOTE OFF
지원하는 제어 명령이 없는 디바이스의 경우 (remoteControl이 false일 때)
400
2302
Command not supported in {STATE (Exception Code)}
해당 STATE에서는 해당 제어 명령을 지원하지 않음 예: "Command not supported in HEAT (2302)"
400
2303
Command not supported in ERROR
디바이스가 에러 상태여서 제어가 불가능한 경우
400
2304
Command not supported in POWER OFF
디바이스 전원이 꺼져있어서 제어가 불가능한 경우
400
2305
Command not supported in {MODE (Exception Code)}
해당 MODE에서는 해당 제어 명령을 지원하지 않음 예: "Command not supported in STANDBY (2305)"
400
Last updated