Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

오류 메시지

오류 조건은 개발 주기의 일부이며, 유효하지 않거나 누락된 매개변수와 같은 단순한 오류에서부터 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 각 개별 호출에 고유한 오류 식별자를 보유하는 텍스트 문자열입니다. 서비스 문제를 신고하면 Google에서 인스턴스 번호를 요청할 수 있습니다.
details 선택사항. message에 삽입되는 변수가 포함되어 있습니다. 메시지에는 여러 변수가 포함될 수 있습니다.

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

차단됨

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

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

연기/공조 안전 차단 중에는 팬을 활성화할 수 없습니다.

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

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

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

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

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

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

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
error에너지 절약 이벤트 중에는 HVAC 모드를 변경할 수 없습니다.
typehttps://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 잘못된 요청
errorHVAC 모드를 $mode 모드로 변경할 수 없습니다. HVAC는 $action할 수 없습니다.
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
messageHVAC 모드를 $mode 모드로 변경할 수 없습니다. HVAC는 $action할 수 없습니다.
details$mode
$action

온도 조절기 잠금이 사용 설정된 상태에서 HVAC 모드를 변경할 수 없습니다.

제품이 데이터를 쓰려면 사용자가 온도 조절기를 잠금 해제해야 합니다.

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

C 및 F 온도를 동시에 설정할 수 없음

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
errorC 및 F 온도를 동시에 설정할 수 없음
typehttps://developers.nest.com/reference/error-messages#multiple-value-changes
messageC 및 F 온도를 동시에 설정할 수 없음

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

HVAC 시스템 팬이 이미 수동으로 또는 사용자 일정에 따라, 또는 HVAC 난방/냉방 주기로 인해 참여 중입니다.

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
error호환되지 않는 모드 $mode으로 인해 fan_timer_active를 사용/사용 중지할 수 없습니다.
typehttps://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 잘못된 요청
errorfan_timer_duration을 선택한 값으로 설정할 수 없습니다. 허용되는 값은 API 참조를 확인하세요.
typehttps://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
messagefan_timer_duration을 선택한 값으로 설정할 수 없습니다. 허용되는 값은 API 참조를 확인하세요.

희망 온도를 목표 고온보다 높게 설정할 수 없음

온도 조절기가 heat-cool 모드로 설정되어 있으며 제품이 범위를 벗어나는 낮은 온도로 설정하려고 시도했습니다. 예를 들어 target_temperature_high_c가 24°C일 때 제품은 target_temperature_low_c를 25°C로 설정하려고 했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
error목표 최저 기온 $lowTemp을(를) 최고 기온 $highTemp보다 높게 설정할 수 없습니다.
typehttps://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보다 높게 설정할 수 없음
typehttps://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는 희망 온도 값일 수 있고 $modeeco, emer_heat_enable, heat-cool, heat, cool, off, hvac_safety_shutoff_active 중 하나일 수 있습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
error모드가 $mode인 동안에는 target_temperature를 설정할 수 없습니다.
typehttps://developers.nest.com/reference/error-messages#mode-error
message모드가 $mode인 동안에는 $fieldName를 설정할 수 없습니다.
details$fieldName
$mode

HVAC 모드를 변경하려면 먼저 기기 펌웨어를 업데이트해야 합니다.

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
errorHVAC 모드를 변경하려면 기기 펌웨어를 업데이트해야 합니다. 업데이트는 자동으로 출시되며 보통 출시 후 1주일 이내입니다.
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
messageHVAC 모드를 변경하려면 기기 펌웨어를 업데이트해야 합니다. 업데이트는 자동으로 출시되며 보통 출시 후 1주일 이내입니다.

WWN 필드를 검증하는 동안 오류가 발생했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
errorWWN 필드를 검증하는 중에 오류 발생: $error
typehttps://developers.nest.com/reference/error-messages#where-id-internal
messageWWN 필드를 검증하는 중에 오류 발생: $error
details$error

ETA가 과거입니다

지정된 ETA 시간이 과거입니다 (지금 이전). ETA 전화 걸기에 대한 자세한 내용은 외출 및 도착 시간 가이드를 참고하세요.

매개변수
HTTP 상태 코드: 400 잘못된 요청
error도착예정시간: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
typehttps://developers.nest.com/reference/error-messages#eta-in-the-past
message도착예정시간: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details$estimatedArrivalTime
$currentTime

예상 도착 시간이 너무 먼 미래입니다

지정된 도착예정시간은 8시간 이하여야 합니다. ETA 전화 걸기에 대한 자세한 내용은 외출 및 도착 시간 가이드를 참고하세요.

매개변수
HTTP 상태 코드: 400 잘못된 요청
error도착 예정 시간이 너무 깁니다
typehttps://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
message도착 예정 시간이 너무 깁니다

fan_timer_active가 설정되지 않음

fan_timer_active가 정의되지 않습니다.

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

금지됨

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

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

내부 오류

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

카메라 ID가 잘못되었습니다.

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

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

잘못된 콘텐츠가 전송됨

통화에 잘못된 콘텐츠가 포함되어 있습니다. 예를 들어 부울 변수에 "true" 대신 "yes"를 사용할 수 있습니다.

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

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

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

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

HVAC 모드가 잘못되었습니다.

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

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

잘못된 연기+co 경보 ID

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
error잘못된 연기+co 알람 ID$id
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message잘못된 연기+co 경보 ID: $id
details$id

잘못된 집 ID

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

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

온도 조절기 ID가 잘못되었습니다.

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
error온도 조절기 ID $id이(가) 잘못되었습니다.
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
message온도 조절기 ID가 잘못됨: $id
details$id

외출 값이 잘못되었습니다.

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
error외출 값이 잘못되었습니다.
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
message잘못된 값: $value 'home' 및 'away'만 허용되는 값입니다.
details$value

is_streaming은 부울이 아님

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

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

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

이 제품은 256자가 넘는 온도 조절기 라벨을 만들려고 했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
error라벨은 $max_label_length자(영문 기준) 미만이어야 합니다.
typehttps://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 맞춤이 최대 개수에 도달했습니다.
typehttps://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의 이름이 다음을 초과하는 최대 맞춤 설정
typehttps://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 입력란에 입력하지 않았습니다.
typehttps://developers.nest.com/reference/error-messages#field-is-missing
message$fieldName 입력란에 입력하지 않았습니다.
details$fieldName

장소 ID 누락

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
errorID 누락
typehttps://developers.nest.com/reference/error-messages#where-id-missing
messageID 누락

HVAC 팬 없음

HVAC 시스템이 독립적인 팬이 없는 것으로 보입니다.

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

온라인 온도 조절기 없음

온도 조절기가 현재 오프라인 상태입니다. Wi-Fi가 사용 설정되면 제품은 다시 액세스할 수 있습니다.

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

페어링된 기기가 없음

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

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

취소할 수 있는 유효한 도착예정시간 없음

이동이 유효하지 않으므로 취소할 수 없습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
error취소할 수 있는 유효한 도착예정시간 없음
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
message취소할 수 있는 유효한 도착예정시간 없음

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

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

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

올바른 요청 유형이 아님

요청 유형이 유효하지 않습니다. 예를 들어 PUT 호출은 PUT이 필요할 때 이루어졌습니다.

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

찾을 수 없음

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

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

외출 모드가 아님

집 구성원이 도착예정시간을 호출할 때 집이 외출 모드가 아닙니다. ETA 호출은 구조가 외출로 설정된 경우에만 허용됩니다.

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

쓰기 불가능

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

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

이름을 입력해야 하는 경우에만

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

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

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

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
errorPOST가 올바른 요청 유형이 아닙니다.
typehttps://developers.nest.com/reference/error-messages#invalid-request-type
messagePOST가 올바른 요청 유형이 아닙니다.

스키마 위반

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

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

서비스를 사용할 수 없음

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

집에 이미 허용되는 최대 페어링된 기기 수가 있습니다.

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

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

사용자가 소유한 집이 아님

structure_id이(가) 기록된 사용자 계정과 일치하지 않습니다.

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

C 온도가 너무 높아서 온도를 유지할 수 없습니다.

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
error$highLockTemp의 잠금 온도인 $tempC 온도가 너무 높습니다.
typehttps://developers.nest.com/reference/error-messages#high-c-value-4-lock
message$highLockTemp의 잠금 온도인 $tempC 온도가 너무 높습니다.
details$tempC
$highLockTemp

C 온도가 너무 낮아 잠금 온도를 설정할 수 없습니다.

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
error$lowLockTemp 온도 조절기의 온도 $tempC이(가) 너무 낮아서 온도를 유지할 수 없습니다.
typehttps://developers.nest.com/reference/error-messages#low-c-value-4-lock
message$lowLockTemp 온도 조절기의 온도 $tempC이(가) 너무 낮아서 온도를 유지할 수 없습니다.
details$tempC
$lowLockTemp

C 온도 값이 너무 높음

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
errorC 온도 값이 너무 높음: $tempC
typehttps://developers.nest.com/reference/error-messages#high-c-value
messageC 온도 값이 너무 높음: $tempC
details$tempC

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

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
errorC 온도 값이 너무 낮음: $tempC
typehttps://developers.nest.com/reference/error-messages#low-c-value
messageC 온도 값이 너무 낮음: $tempC
details$tempC

잠금 온도를 선택하기 위해 온도 F가 너무 높음

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
error$highLockTemp의 온도를 고정하기 위한 $tempF 온도가 너무 높습니다.
typehttps://developers.nest.com/reference/error-messages#high-f-value-4-lock
message$highLockTemp의 온도를 고정하기 위한 $tempF 온도가 너무 높습니다.
details$tempF
$highLockTemp

잠금 온도를 파악하기 위해 F 온도가 너무 낮습니다.

사용자가 온도 조절기를 잠겼으며 제품에서 잠금 온도 범위보다 낮은 희망 온도를 설정하려고 했습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
error$lowLockTemp 온도가 너무 낮아서 온도 F $tempF이(가) 너무 낮음
typehttps://developers.nest.com/reference/error-messages#low-f-value-4-lock
message$lowLockTemp 온도가 너무 낮아서 온도 F $tempF이(가) 너무 낮음
details$tempF
$lowLockTemp

온도 F 값이 너무 큼

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

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

온도 F 값이 너무 낮음

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
error온도 F 값이 너무 낮음: $tempF
typehttps://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 온도 형식이 잘못되었습니다.
typehttps://developers.nest.com/reference/error-messages#format-error
message$temp 온도 형식이 잘못되었습니다.
details$temp

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

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

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

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

입력란이 ISO 8601 형식이 아닙니다.

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

온도 조절기가 온라인 상태가 아닙니다.

온도 조절기가 현재 오프라인 상태입니다. Wi-Fi가 사용 설정되면 제품은 다시 액세스할 수 있습니다.

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

이 여행은 수동으로 재정의되었습니다.

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
error이 여행은 수동으로 재정의되었습니다.
typehttps://developers.nest.com/reference/error-messages#trip-manually-overidden
message이 여행은 수동으로 재정의되었습니다.

장소 ID를 만들 수 없음

wheres 객체가 누락되었습니다. where_id 값은 정의되어 있지 않습니다.

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

승인되지 않음

승인할 수 없습니다.

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

  • 잘못된 HTTP 리디렉션이 승인 헤더를 리디렉션된 URI에 자동으로 전달하지 않을 때 발생합니다. 자세한 내용은 리디렉션 처리 방법을 참고하세요.

  • API 엔드포인트에 액세스하려고 할 때 잘못된 권한이 포함됨 예를 들어 클라이언트에 대해 카메라 권한만 선택한 경우 온도 조절기 엔드포인트를 읽으려고 시도합니다. 자세한 내용은 권한 선택 방법을 참고하세요.

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

알 수 없음

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

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

기기 페어링 중에 공급업체/기기가 인식되지 않습니다.

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

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

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

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

이름이 이미 있는 위치

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
error$name 이름이 이미 존재하는 위치
typehttps://developers.nest.com/reference/error-messages#where-name-exists
message$name 이름이 이미 존재하는 위치
details$name

이름이 제공되지 않은 경우

where_name을(를) 호출할 수 없습니다.

매개변수
HTTP 상태 코드: 400 잘못된 요청
error이름이 제공되지 않은 경우
typehttps://developers.nest.com/reference/error-messages#where-name-missing
message이름이 제공되지 않은 경우

이름이 0인 경우

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

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

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

where_name에 잘못된 데이터 유형이 전송되었습니다. 예를 들어 문자열이 필요할 것으로 예상되는 숫자를 사용합니다.

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

where_id가 존재하지 않습니다.

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

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

where_id는 문자열이어야 합니다.

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

매개변수
HTTP 상태 코드: 400 잘못된 요청
errorwhere_id는 문자열이어야 합니다.
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messagewhere_id는 문자열이어야 합니다.

기타 오류 코드 및 메시지

기기 오류 코드

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

REST 오류 코드

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

REST 비율 제한 메시지

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

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