Notice: We're retiring Works with Nest. See the home page for more information.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

오류 메시지

오류 조건은 개발 주기의 일부이며 잘못되거나 누락된 매개변수와 같은 단순한 오류에서부터 예기치 않은 상태나 기기 관련 설정과 같이 API 외부에서 해결되어야 하는 보다 복잡한 시나리오에 이르기까지 다양합니다.

API 호출 중에 오류가 발생하면 다음 형식의 응답이 전송됩니다.

{
  "error": "Temperature '$temp' is in wrong format",
  "type": "https://developers.nest.com/documentation/cloud/error-messages#format-error",
  "message": "Temperature '$temp' is in wrong format",
  "instance": "31441a94-ed26-11e4-90ec-1681e6b88ec1",
  "details": {
    "field_name": "$temp"
  }
}

모든 오류 메시지에는 error, type, message, instance 필드가 포함됩니다. details 객체는 선택사항입니다.

필드	설명
`error`	짧은 오류 메시지 형식입니다.
`type`	오류 조건에 대한 자세한 내용 URL을 제공합니다 (이 페이지).
`message`	변수를 사용하여 추가 세부정보를 제공할 수 있는 긴 오류 메시지 형식입니다. 메시지에 변수가 포함되면 `details` 객체에 나타납니다.
`instance`	각 호출마다 고유한 오류 식별자가 포함된 텍스트 문자열입니다. 서비스 문제를 신고하면 인스턴스 번호를 요청할 수 있습니다.
`details`	선택사항. `message`에 삽입되는 변수를 포함합니다. 메시지에는 여러 변수가 포함될 수 있습니다.

Nest API와 관련 없는 오류에 관한 자세한 내용은 기타 오류 코드 및 메시지를 참고하세요.

차단됨

비율 제한을 초과했습니다.

매개변수
HTTP 상태 코드: 429 요청이 너무 많음
`error`	차단됨
`type`	`https://developers.nest.com/reference/error-messages#blocked`
`message`	차단됨

연기/일산화탄소 안전 차단 중에는 팬을 활성화할 수 없습니다.

긴급 종료가 적용됩니다. 정상 작동이 복원될 때까지 API 호출이 허용되지 않습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	연기/일산화탄소 안전 차단 중에는 팬을 활성화할 수 없습니다.
`type`	`https://developers.nest.com/reference/error-messages#safety-shutoff-on`
`message`	연기/일산화탄소 안전 차단 중에는 팬을 활성화할 수 없습니다.

응급 난방이 켜져 있는 동안에는 외출 상태를 변경할 수 없습니다.

제품이 긴급 난방이 켜져 있을 때 외출 상태를 변경하려고 했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	응급 난방이 켜져 있는 동안에는 외출 상태를 변경할 수 없습니다.
`type`	`https://developers.nest.com/reference/error-messages#emergency-heat-is-on`
`message`	응급 난방이 켜져 있는 동안에는 외출 상태를 변경할 수 없습니다.

에너지 절약 이벤트 중에는 HVAC 모드를 변경할 수 없습니다.

Nest 에너지 파트너가 정의한 에너지 절약 이벤트가 적용됩니다. 에너지 절약 이벤트가 종료될 때까지 API 호출이 거부됩니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	에너지 절약 이벤트 중에는 HVAC 모드를 변경할 수 없습니다.
`type`	`https://developers.nest.com/reference/error-messages#energy-saving-event-on`
`message`	에너지 절약 이벤트 중에는 HVAC 모드를 변경할 수 없습니다.

HVAC 모드를 변경할 수 없음

모드가 요청과 호환되지 않습니다.

예를 들어 다음과 같은 경우에 이 메시지가 표시될 수 있습니다.

온도 조절기의 HVAC 시스템이 heat, cool, heat-cool 또는 eco 제품에서 요청한 모드를 지원하지 않습니다.
HVAC 모드가 eco로 설정되어 있고 제품이 target_temperature을 설정하려고 합니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	HVAC 모드를 `$mode` 모드로 변경할 수 없습니다. HVAC 모드는 `$action`할 수 없습니다.
`type`	`https://developers.nest.com/reference/error-messages#incompatible-mode`
`message`	HVAC 모드를 `$mode` 모드로 변경할 수 없습니다. HVAC 모드는 `$action`할 수 없습니다.
`details`	`$mode $action`

온도 조절기 잠금이 사용 설정되어 있는 동안에는 HVAC 모드를 변경할 수 없습니다.

사용자가 온도 조절기를 잠금 해제해야 제품에서 데이터를 쓸 수 있습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	온도 조절기 잠금이 사용 설정되어 있는 동안에는 HVAC 모드를 변경할 수 없습니다.
`type`	`https://developers.nest.com/reference/error-messages#lock-enabled`
`message`	온도 조절기 잠금이 사용 설정되어 있는 동안에는 HVAC 모드를 변경할 수 없습니다.

C와 F 온도는 동시에 설정할 수 없음

이 제품은 섭씨 및 화씨 온도를 모두 동시에 설정하려고 했습니다. 제품에서는 temperature_scale(C/F)에서 지정한 목표 온도만 설정해야 합니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	C와 F 온도는 동시에 설정할 수 없음
`type`	`https://developers.nest.com/reference/error-messages#multiple-value-changes`
`message`	C와 F 온도는 동시에 설정할 수 없음

호환되지 않는 모드로 인해 fan_timer_active를 사용/사용 중지할 수 없습니다.

HVAC 시스템 팬이 이미 참여하고 있습니다 (사용자가 직접 또는 일정에 따라 또는 HVAC 난방/냉방 주기로 인해).

예상된 결과를 얻지 못하면 API를 통해 재정의할 수 없는 기본 제공 동작이 기기에 있기 때문일 가능성이 높습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	`$mode` 모드가 호환되지 않아 fan_timer_active를 사용/사용 중지할 수 없습니다.
`type`	`https://developers.nest.com/reference/error-messages#incompatible-fan-mode`
`message`	`$mode` 모드가 호환되지 않아 fan_timer_active를 사용/사용 중지할 수 없습니다.
`details`	`$mode`

fan_timer_duration을 선택한 값으로 설정할 수 없습니다.

제품이 fan_timer_duration을(를) 잘못된 값으로 설정하려고 했습니다. 유효한 값 목록은 fan_timer_duration를 참고하세요.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	fan_timer_duration을 선택한 값으로 설정할 수 없습니다. 허용되는 값은 API 참조를 확인하세요.
`type`	`https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration`
`message`	fan_timer_duration을 선택한 값으로 설정할 수 없습니다. 허용되는 값은 API 참조를 확인하세요.

희망 온도를 최고 온도보다 높게 설정할 수 없습니다.

온도 조절기가 heat-cool 모드이고 제품에서 목표 온도를 설정 범위를 벗어난 최저/최고 온도로 설정하려고 했습니다. 예를 들어 target_temperature_high_c가 24°C일 때 target_temperature_low_c를 25°C로 설정하려고 했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	희망 온도(`$lowTemp`)를 목표 최고 온도(`$highTemp`)보다 높게 설정할 수 없습니다.
`type`	`https://developers.nest.com/reference/error-messages#low-high-error`
`message`	희망 온도(`$lowTemp`)를 목표 최고 온도(`$highTemp`)보다 높게 설정할 수 없습니다.
`details`	`$lowTemp $highTemp`

희망 온도를 N도 C/F보다 높게 설정할 수 없습니다.

제품이 목표 온도를 최고 기온/최저 온도에 너무 가깝게 설정하려고 시도했습니다 (예: target_temperature_high_f).

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	희망 온도를 N도 C/F보다 높게 설정할 수 없습니다.
`type`	`https://developers.nest.com/reference/error-messages#range-error`
`message`	희망 온도를 `$min`도 `$scale` 이상으로 설정할 수 없습니다.
`details`	`$min` `$scale`

모드가 $mode인 동안에는 target_temperature를 설정할 수 없습니다.

온도 조절기 또는 구조가 현재 API 요청을 지원하지 않는 모드입니다.

예를 들어 HVAC 시스템이 off이거나 heat-cool 모드일 때 target_temperature_f 또는 target_temperature_c를 설정할 수 없습니다. 온도 조절기/구조체가 제한 없는 모드로 다시 전환될 때까지 값을 변경할 수 없습니다.

이 메시지에서 $fieldName는 원하는 온도 값이 될 수 있으며 $mode는 eco, emer_heat_enable, heat-cool, heat, cool, off, hvac_safety_shutoff_active 중 하나일 수 있습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	모드가 `$mode`인 경우 target_temperature를 설정할 수 없습니다.
`type`	`https://developers.nest.com/reference/error-messages#mode-error`
`message`	모드가 `$mode`일 때는 `$fieldName`을(를) 설정할 수 없습니다.
`details`	`$fieldName $mode`

HVAC 모드를 변경하려면 기기 펌웨어 업데이트가 필요합니다.

절전 온도를 설정하려면 기기를 현재 펌웨어 버전으로 업데이트해야 합니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	HVAC 모드를 변경하려면 기기 펌웨어 업데이트가 필요합니다. 업데이트는 자동으로 출시되며 일반적으로 출시 후 일주일이 걸립니다.
`type`	`https://developers.nest.com/reference/error-messages#unsupported-firmware-version`
`message`	HVAC 모드를 변경하려면 기기 펌웨어 업데이트가 필요합니다. 업데이트는 자동으로 출시되며 일반적으로 출시 후 일주일이 걸립니다.

WWN 필드의 유효성을 검사하는 중에 오류가 발생했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	WWN 필드를 확인하는 중에 오류가 발생했습니다. `$error`
`type`	`https://developers.nest.com/reference/error-messages#where-id-internal`
`message`	WWN 필드를 확인하는 중에 오류가 발생했습니다. `$error`
`details`	`$error`

ETA는 과거입니다.

지정된 ETA 시간이 과거입니다 (NOW 이전). ETA 호출에 대해 자세히 알아보려면 외출 및 ETA 가이드를 참고하세요.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	ETA는 과거입니다. `$estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime`
`type`	`https://developers.nest.com/reference/error-messages#eta-in-the-past`
`message`	ETA는 과거입니다. `$estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime`
`details`	`$estimatedArrivalTime $currentTime`

예상 도착 시간이 너무 먼 미래로 설정되어 있습니다

지정된 ETA 시간은 8시간 이하여야 합니다. ETA 호출에 대해 자세히 알아보려면 외출 및 ETA 가이드를 참고하세요.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	예상 도착 시간이 너무 먼 미래로 설정되어 있습니다
`type`	`https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future`
`message`	예상 도착 시간이 너무 먼 미래로 설정되어 있습니다

fan_timer_active 설정되지 않음

fan_timer_active가 정의되지 않습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	fan_timer_active 설정되지 않음
`type`	`https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing`
`message`	fan_timer_active 설정되지 않음

금지됨

Nest 서비스에 액세스하는 데 사용하는 사용자 인증 정보가 잘못되었습니다.

매개변수
HTTP 상태 코드: 403 금지됨
`error`	금지됨
`type`	`https://developers.nest.com/reference/error-messages#forbidden`
`message`	금지됨

내부 오류

매개변수
HTTP 상태 코드: 500 내부 서버 오류
`error`	내부 오류
`type`	`https://developers.nest.com/reference/error-messages#internal-error`
`message`	내부 오류

잘못된 카메라 ID

camera-id이(가) 잘못되었습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	잘못된 카메라 ID `$id`
`type`	`https://developers.nest.com/reference/error-messages#invalid-camera-id`
`message`	잘못된 카메라 ID: `$id`
`details`	`$id`

잘못된 콘텐츠가 전송됨

호출에 잘못된 콘텐츠가 포함되어 있습니다. 예를 들어 불리언 변수에 'true' 대신 'yes'를 사용합니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	잘못된 콘텐츠가 전송됨
`type`	`https://developers.nest.com/reference/error-messages#invalid-content-sent`
`message`	잘못된 콘텐츠가 전송됨

프래그먼트 경로가 잘못되었습니다.

요청 경로의 일부가 잘못되었습니다. 예를 들어 객체 또는 필드 이름의 철자가 틀릴 수 있습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	잘못된 프래그먼트 경로: `$requestPath`
`type`	`https://developers.nest.com/reference/error-messages#invalid-fragment`
`message`	잘못된 프래그먼트 경로: `$requestPath`
`details`	`$requestPath`

HVAC 모드가 잘못됨

온도 조절기의 HVAC 시스템이 제품에서 요청한 모드(heat, cool 또는 heat-cool)를 지원하지 않습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	HVAC 모드가 잘못됨: `$mode`
`type`	`https://developers.nest.com/reference/error-messages#invalid-mode`
`message`	HVAC 모드가 잘못됨: `$mode`
`details`	`$mode`

잘못된 연기/일산화탄소 경보기 ID

smoke_co_alarm_id이(가) 잘못되었습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	잘못된 연기/일산화탄소 경보기 ID `$id`
`type`	`https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id`
`message`	잘못된 연기/일산화탄소 경보기 ID: `$id`
`details`	`$id`

잘못된 구조 ID

structure_id이(가) 잘못되었습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	잘못된 집 ID `$id`
`type`	`https://developers.nest.com/reference/error-messages#invalid-structure-id`
`message`	잘못된 구조 ID: `$id`
`details`	`$id`

잘못된 온도 조절기 ID

thermostat_id이(가) 잘못되었습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	잘못된 온도 조절기 ID `$id`
`type`	`https://developers.nest.com/reference/error-messages#invalid-thermostat-id`
`message`	잘못된 온도 조절기 ID: `$id`
`details`	`$id`

외출 값이 잘못됨

away에 잘못된 값을 설정하려고 했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	외출 값이 잘못됨
`type`	`https://developers.nest.com/reference/error-messages#invalid-away-value`
`message`	잘못된 값: `$value` '재택' 및 '외출' 값만 허용됩니다.
`details`	`$value`

is_streaming은 부울이 아님

제품이 is-streaming 필드를 부울이 아닌 값으로 설정하려고 했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	is_streaming은 부울이 아님
`type`	`https://developers.nest.com/reference/error-messages#invalid-is-stream-format`
`message`	is_streaming은 부울이 아님

라벨은 256자(영문 기준) 미만이어야 합니다.

제품이 256자(영문 기준)를 초과하는 온도 조절기 라벨을 생성하려고 했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	라벨은 `$max_label_length`자(영문 기준) 미만이어야 합니다.
`type`	`https://developers.nest.com/reference/error-messages#max-label-length`
`message`	라벨은 `$max_label_length`자(영문 기준) 미만이어야 합니다.
`details`	`$max_label_length`

개수가 맞춤설정되는 최대 맞춤 개수

제품이 최댓값을 초과하는 맞춤 wheres 객체를 만들려고 했습니다. 허용되는 맞춤 wheres 객체의 최대 개수는 32개입니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	`$max_where_count` 수를 초과한 최대 맞춤 수
`type`	`https://developers.nest.com/reference/error-messages#max-where-count`
`message`	`$max_where_count` 수를 초과한 최대 맞춤 수
`details`	`$max_where_count`

최대 맞춤 이름(이름 길이 초과)

name이(가) 너무 깁니다. 30자 미만이 좋습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	맞춤 길이가 최대 길이인 `$max_custom_where_name_length` 맞춤
`type`	`https://developers.nest.com/reference/error-messages#max-where-name-length`
`message`	맞춤 길이가 최대 길이인 `$max_custom_where_name_length` 맞춤
`details`	`$max_custom_where_name_length`

입력란이 누락되었습니다.

호출에 필수 매개변수가 누락되었습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	`$fieldName` 입력란에 입력하지 않았습니다.
`type`	`https://developers.nest.com/reference/error-messages#field-is-missing`
`message`	`$fieldName` 입력란에 입력하지 않았습니다.
`details`	`$fieldName`

장소 ID 누락

where_id 형식이 누락되었습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	ID 입력 누락
`type`	`https://developers.nest.com/reference/error-messages#where-id-missing`
`message`	ID 입력 누락

HVAC 팬 없음

HVAC 시스템에 독립적인 선풍기가 없는 것 같습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	HVAC 팬 없음
`type`	`https://developers.nest.com/reference/error-messages#no-hvac-fan`
`message`	HVAC 팬 없음

온라인 온도 조절기 없음

온도 조절기가 현재 오프라인 상태입니다. Wi-Fi가 사용 설정되면 제품에 액세스 권한이 다시 부여됩니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	온라인 온도 조절기 없음
`type`	`https://developers.nest.com/reference/error-messages#no-thermostats-online`
`message`	온라인 온도 조절기 없음

페어링된 기기가 없음

사용자의 Nest 기기가 사용자의 Nest 계정과 페어링되지 않았습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	페어링된 기기가 없음
`type`	`https://developers.nest.com/reference/error-messages#no-paired-devices`
`message`	페어링된 기기가 없음

취소할 ETA가 없습니다.

이동이 잘못되어 취소할 수 없습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	취소할 ETA가 없습니다.
`type`	`https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel`
`message`	취소할 ETA가 없습니다.

필드에 쓰기 권한이 없습니다.

클라이언트에 이 데이터에 대한 쓰기 권한이 없습니다. 자세한 내용은 권한 개요를 참고하세요.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	`$fields` 필드에 대한 쓰기 권한 없음
`type`	`https://developers.nest.com/reference/error-messages#no-write-permission`
`message`	`$fields` 필드에 대한 쓰기 권한 없음
`details`	`$fields`

올바른 요청 유형이 아닙니다.

요청 유형이 잘못되었습니다. 예를 들어 PUT 호출은 PUT이 필요할 때 이루어졌습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	올바른 요청 유형이 아닙니다. `$requestType`
`type`	`https://developers.nest.com/reference/error-messages#request-type-not-allowed`
`message`	올바른 요청 유형이 아닙니다. `$requestType`
`details`	`$requestType`

찾을 수 없음

호출이 존재하지 않는 경로를 읽으려고 시도했습니다.

매개변수
HTTP 상태 코드: 404 찾을 수 없음
`error`	찾을 수 없음
`type`	`https://developers.nest.com/reference/error-messages#not-found`
`message`	찾을 수 없음

외출 모드가 아님

ETA 호출이 이루어진 경우 집이 외출 모드가 아닙니다. ETA 호출은 구조가 '부재중'으로 설정된 경우에만 수락됩니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	외출 모드가 아님
`type`	`https://developers.nest.com/reference/error-messages#not-in-away-mode`
`message`	외출 모드가 아님

쓰기 불가능

쓰려는 필드가 읽기 전용입니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	쓰기 불가능
`type`	`https://developers.nest.com/reference/error-messages#not-writable`
`message`	쓰기 불가능

이름을 제공해야 하는 경우에만

추가 필드는 wheres 호출에 포함되었습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	이름을 제공해야 하는 경우에만
`type`	`https://developers.nest.com/reference/error-messages#extra-fields`
`message`	이름을 제공해야 하는 경우에만

POST은(는) 유효한 요청 유형이 아닙니다.

요청 유형이 잘못되었습니다. 예를 들어 PUT 호출은 PUT이 필요할 때 이루어졌습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	POST은(는) 유효한 요청 유형이 아닙니다.
`type`	`https://developers.nest.com/reference/error-messages#invalid-request-type`
`message`	POST은(는) 유효한 요청 유형이 아닙니다.

스키마 위반

기기를 페어링하는 중에 오류가 발생했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	스키마 위반
`type`	`https://developers.nest.com/reference/error-messages#schema-violation-error`
`message`	스키마 위반

서비스를 사용할 수 없음

매개변수
HTTP 상태 코드: 503 서비스를 사용할 수 없음
`error`	서비스를 사용할 수 없음
`type`	`https://developers.nest.com/reference/error-messages#service-unavailable`
`message`	서비스를 사용할 수 없음

집에 이미 최대 개수의 기기가 페어링되어 있습니다.

구조에 이미 허용되는 최대 기기 수가 있습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	집에 이미 최대 개수의 기기가 페어링되어 있습니다.
`type`	`https://developers.nest.com/reference/error-messages#max-number-devices-error`
`message`	집에 이미 최대 개수의 기기가 페어링되어 있습니다.

사용자가 소유하지 않은 구조입니다.

structure_id이(가) 레코드의 사용자 계정과 일치하지 않습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	사용자가 소유한 집이 아닙니다.
`type`	`https://developers.nest.com/reference/error-messages#structure-ownership-error-uri`
`message`	사용자가 소유한 집이 아닙니다.

C 온도가 너무 높아 잠금 온도를 사용할 수 없음

사용자가 온도 조절기를 잠갔습니다. 제품에서 섭씨 온도를 잠금 온도 범위보다 높게 설정하려고 했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	`$tempC` 온도가 너무 높아서 잠금 온도 `$highLockTemp`에 실패했습니다.
`type`	`https://developers.nest.com/reference/error-messages#high-c-value-4-lock`
`message`	`$tempC` 온도가 너무 높아서 잠금 온도 `$highLockTemp`에 실패했습니다.
`details`	`$tempC $highLockTemp`

온도 C가 너무 낮아 잠금 온도를 설정할 수 없음

사용자가 온도 조절기를 잠갔습니다. 제품에서 섭씨 온도를 잠금 온도 범위보다 낮게 설정하려고 했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	온도 C가 `$tempC` 온도가 너무 낮아 잠금 온도보다 낮습니다. `$lowLockTemp`
`type`	`https://developers.nest.com/reference/error-messages#low-c-value-4-lock`
`message`	온도 C가 `$tempC` 온도가 너무 낮아 잠금 온도보다 낮습니다. `$lowLockTemp`
`details`	`$tempC $lowLockTemp`

온도 C 값이 너무 큽니다.

제품이 섭씨보다 너무 높은 목표 온도 값을 설정하려고 했습니다. 섭씨에서 허용되는 온도 범위는 target_temperature_c를 참고하세요.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	온도 C 값이 너무 큽니다: `$tempC`
`type`	`https://developers.nest.com/reference/error-messages#high-c-value`
`message`	온도 C 값이 너무 큽니다: `$tempC`
`details`	`$tempC`

온도 C 값이 너무 낮습니다.

제품이 섭씨 온도에 비해 너무 낮은 목표 온도 값을 설정하려고 했습니다. 섭씨에서 허용되는 온도 범위는 target_temperature_c를 참고하세요.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	온도 C 값이 너무 낮습니다. `$tempC`
`type`	`https://developers.nest.com/reference/error-messages#low-c-value`
`message`	온도 C 값이 너무 낮습니다. `$tempC`
`details`	`$tempC`

온도가 너무 높아서 잠금 온도를 사용할 수 없음

사용자가 온도 조절기를 잠갔습니다. 제품이 화씨 희망 온도를 잠금 온도 범위보다 높게 설정하려고 했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	온도 F가 `$tempF` 너무 높아서 잠금 온도보다 낮아질 수 있습니다. `$highLockTemp`
`type`	`https://developers.nest.com/reference/error-messages#high-f-value-4-lock`
`message`	온도 F가 `$tempF` 너무 높아서 잠금 온도보다 낮아질 수 있습니다. `$highLockTemp`
`details`	`$tempF $highLockTemp`

온도 F가 너무 낮아 잠금 온도를 사용할 수 없음

사용자가 온도 조절기를 잠갔습니다. 제품이 희망 온도를 잠금 온도 범위보다 낮게 설정하려고 했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	온도 F가 `$tempF` 너무 낮아서 잠금 온도가 유지되지 않습니다.`$lowLockTemp`
`type`	`https://developers.nest.com/reference/error-messages#low-f-value-4-lock`
`message`	온도 F가 `$tempF` 너무 낮아서 잠금 온도가 유지되지 않습니다.`$lowLockTemp`
`details`	`$tempF $lowLockTemp`

온도 F 값이 너무 높습니다.

제품이 화씨 온도에 비해 너무 높은 목표 온도 값을 설정하려고 했습니다. 화씨에서 허용되는 온도 범위는 target_temperature_f를 참고하세요.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	온도 F 값이 너무 높습니다: `$tempF`
`type`	`https://developers.nest.com/reference/error-messages#high-f-value`
`message`	온도 F 값이 너무 높습니다: `$tempF`
`details`	`$tempF`

온도 F 값이 너무 낮습니다.

제품이 화씨 온도에 비해 너무 낮은 목표 온도 값을 설정하려고 했습니다. 화씨에서 허용되는 온도 범위는 target_temperature_f를 참고하세요.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	온도 F 값이 너무 낮습니다. `$tempF`
`type`	`https://developers.nest.com/reference/error-messages#low-f-value`
`message`	온도 F 값이 너무 낮습니다. `$tempF`
`details`	`$tempF`

온도 형식이 잘못되었습니다.

제품이 선택한 temperature_scale에 대해 잘못된 숫자 형식을 사용하여 희망 온도를 설정하려고 했습니다. 섭씨 온도는 0.5도 단위로 정수 (21.5)여야 하며 화씨 온도는 정수 (72)여야 합니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	`$temp` 온도 형식이 잘못되었습니다.
`type`	`https://developers.nest.com/reference/error-messages#format-error`
`message`	`$temp` 온도 형식이 잘못되었습니다.
`details`	`$temp`

업데이트 시 필드를 수정할 수 없습니다.

제품이 읽기 전용 필드에 쓰기를 시도했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	업데이트 시 필드를 수정할 수 없습니다. `$fieldNames`
`type`	`https://developers.nest.com/reference/error-messages#read-only-field-error`
`message`	업데이트 시 필드를 수정할 수 없습니다. `$fieldNames`
`details`	`$fieldNames`

필드는 ISO 8601 형식을 사용해야 합니다.

필드가 ISO 8601 형식이 아닙니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	필드는 ISO 8601 형식을 사용해야 합니다. `$fieldNames`
`type`	`https://developers.nest.com/reference/error-messages#time-format-error`
`message`	필드는 ISO 8601 형식을 사용해야 합니다. `$fieldNames`
`details`	`$fieldNames`

온도 조절기가 온라인 상태가 아님

온도 조절기가 현재 오프라인 상태입니다. Wi-Fi가 사용 설정되면 제품에 액세스 권한이 다시 부여됩니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	온도 조절기가 온라인 상태가 아님
`type`	`https://developers.nest.com/reference/error-messages#not-online`
`message`	온도 조절기가 온라인 상태가 아님

이 경로는 수동으로 재정의되었습니다.

사용자가 이동을 수동으로 재정의했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	이 경로는 수동으로 재정의되었습니다.
`type`	`https://developers.nest.com/reference/error-messages#trip-manually-overridden`
`message`	이 경로는 수동으로 재정의되었습니다.

장소 ID를 만들 수 없음

wheres 객체가 없습니다. where_id 값은 정의되지 않습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	장소 ID를 만들 수 없음
`type`	`https://developers.nest.com/reference/error-messages#wheres-missing`
`message`	장소 ID를 만들 수 없음

승인되지 않음

승인에 실패했습니다.

몇 가지 조건으로 이 오류 메시지가 표시될 수 있습니다.

지정된 HTTP 구현이 승인 헤더를 리디렉션된 URI에 자동으로 전달하지 않을 때 발생하는 잘못된 리디렉션 자세한 내용은 리디렉션 처리 방법을 참고하세요.
API 엔드포인트에 액세스하려고 할 때 잘못된 권한이 발생함 예를 들어 클라이언트에 대해 카메라 권한만 선택한 경우 온도 조절기 엔드포인트를 읽으려고 합니다. 자세한 내용은 권한 선택 방법을 참고하세요.

매개변수
HTTP 상태 코드: 401 승인되지 않음
`error`	승인되지 않음
`type`	`https://developers.nest.com/reference/error-messages#auth-error`
`message`	승인되지 않음

알 수 없음

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	알 수 없음
`type`	`https://developers.nest.com/reference/error-messages#unknown`
`message`	알 수 없음

알 수 없는 공급업체/기기 유형

기기 페어링 중에 공급업체/기기를 인식할 수 없습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	알 수 없는 공급업체/기기 유형
`type`	`https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error`
`message`	알 수 없는 공급업체/기기 유형

$fieldName 값의 유형이 잘못되었습니다.

잘못된 데이터 유형이 전송되었습니다. 예를 들어 부울이 예상되는 경우 문자열을 전송합니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	`$fieldName` 값이 잘못된 유형입니다.
`type`	`https://developers.nest.com/reference/error-messages#wrong-data-type`
`message`	`$fieldName` 값이 잘못된 유형입니다.
`details`	`$fieldName`

이름이 이미 있는 경우

제품에서 설정하려는 where_name이(가) 이미 존재합니다. 새 이름으로 다시 시도하세요.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	이름이 `$name`인 위치
`type`	`https://developers.nest.com/reference/error-messages#where-name-exists`
`message`	이름이 `$name`인 위치
`details`	`$name`

이름을 입력하지 않은 경우

통화에서 where_name이(가) 누락되었습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	이름을 입력하지 않은 경우
`type`	`https://developers.nest.com/reference/error-messages#where-name-missing`
`message`	이름을 입력하지 않은 경우

이름의 길이가 0인 경우

여기서 name는 정의되지 않습니다 (문자 0개).

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	이름의 길이가 0인 경우
`type`	`https://developers.nest.com/reference/error-messages#zero-length-where-name`
`message`	이름의 길이가 0인 경우

여기서 이름은 문자열이어야 합니다.

where_name에 잘못된 데이터 유형이 전송되었습니다. 예를 들면 문자열이 예상되는 숫자입니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	여기서 이름은 문자열이어야 합니다.
`type`	`https://developers.nest.com/reference/error-messages#where-name-wrong-format`
`message`	여기서 이름은 문자열이어야 합니다.

where_id 이(가) 존재하지 않습니다.

where_id이(가) 잘못되었습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	where_id 이(가) 존재하지 않습니다.
`type`	`https://developers.nest.com/reference/error-messages#where-id-invalid`
`message`	where_id 이(가) 존재하지 않습니다.
`details`	`$where_id`

여기서_id는 문자열이어야 합니다.

where_id 형식이 잘못되었습니다. 예를 들어 문자열 대신 숫자가 전송되었습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
`error`	여기서_id는 문자열이어야 합니다.
`type`	`https://developers.nest.com/reference/error-messages#where-id-wrong-format`
`message`	여기서_id는 문자열이어야 합니다.

기타 오류 코드 및 메시지

기기 오류 코드

Nest API와 관련 없는 기기별 오류 코드 및 메시지는 다음을 참조하세요.

REST 오류 코드

REST API를 호출하면 일반 HTTP 상태 코드가 반환됩니다.

REST 비율 제한 메시지

REST를 사용하고 단기간에 너무 많은 호출을 보내면 HTTP 응답 상태 코드 429 요청이 너무 많을 수 있습니다.

자세한 내용은 데이터 비율 제한을 참조하세요.