Komunikaty o błędach

Warunki błędów są częścią cyklu rozwoju i mogą obejmować proste błędy, takie jak nieprawidłowy lub brakujący parametr, do bardziej złożonych scenariuszy, takich jak nieoczekiwany stan lub nawet ustawienia związane z urządzeniem, które muszą zostać rozwiązane poza interfejsem API.

Gdy wystąpi błąd podczas wywołania API, wysyłana jest odpowiedź w następującym formacie:

{
  "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"
  }
}

Wszystkie komunikaty o błędach zawierają pola error , type , message i instance . details obiekt jest opcjonalny.

Pole	Opis
`error`	Format krótkich komunikatów o błędach.
`type`	Udostępnia adres URL szczegółowych informacji o stanie błędu (ta strona).
`message`	Format długiego komunikatu o błędzie, w którym mogą być używane zmienne w celu podania dodatkowych szczegółów. Kiedy zmienna jest zawarta w wiadomości, pojawi się ona w obiekcie `details` .
`instance`	Ciąg tekstowy zawierający identyfikator błędu, który jest unikalny dla każdego pojedynczego wywołania. Możemy poprosić Cię o numer instancji, jeśli zgłosisz problem z usługą.
`details`	Opcjonalny. Zawiera zmienne wstawiane do `message` . Wiadomości mogą zawierać wiele zmiennych.

Aby uzyskać informacje na temat błędów niezwiązanych z interfejsem Nest API, zobacz Inne kody błędów i komunikaty .

Zablokowany

Przekroczono limit szybkości .

Parametry
Kod stanu HTTP: 429 za dużo żądań
`error`	Zablokowany
`type`	`https://developers.nest.com/reference/error-messages#blocked`
`message`	Zablokowany

Nie można uruchomić wentylatora podczas wyłączania bezpieczeństwa dymu / CO

Działa wyłącznik awaryjny . Wywołania API nie są akceptowane, dopóki nie zostanie przywrócone normalne działanie.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie można uruchomić wentylatora podczas wyłączania bezpieczeństwa dymu / CO
`type`	`https://developers.nest.com/reference/error-messages#safety-shutoff-on`
`message`	Nie można uruchomić wentylatora podczas wyłączania bezpieczeństwa dymu / CO

Nie można zmienić stanu Poza domem, gdy włączone jest ogrzewanie awaryjne

Produkt próbował zmienić stan Poza domem, gdy było włączone ogrzewanie awaryjne .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie można zmienić stanu Poza domem, gdy włączone jest ogrzewanie awaryjne
`type`	`https://developers.nest.com/reference/error-messages#emergency-heat-is-on`
`message`	Nie można zmienić stanu Poza domem, gdy włączone jest ogrzewanie awaryjne

Nie można zmienić trybu HVAC podczas zdarzeń związanych z oszczędzaniem energii

Trwa zdarzenie dotyczące oszczędzania energii określone przez partnera energetycznego Nest. Wywołania API są odrzucane do czasu zakończenia zdarzenia oszczędzania energii.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie można zmienić trybu HVAC podczas zdarzeń związanych z oszczędzaniem energii
`type`	`https://developers.nest.com/reference/error-messages#energy-saving-event-on`
`message`	Nie można zmienić trybu HVAC podczas zdarzeń związanych z oszczędzaniem energii

Nie można zmienić trybu HVAC

Tryb jest niezgodny z żądaniem.

Na przykład możesz otrzymać tę wiadomość, jeśli:

System HVAC termostatu nie obsługuje trybu żądanego przez produkt: heat , cool , heat-cool lub eco
Tryb HVAC jest ustawiony na eco i produkt próbuje ustawić target_temperature

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie można zmienić trybu HVAC na tryb `$mode` ; HVAC nie może `$action`
`type`	`https://developers.nest.com/reference/error-messages#incompatible-mode`
`message`	Nie można zmienić trybu HVAC na tryb `$mode` ; HVAC nie może `$action`
`details`	`$mode $action`

Nie można zmienić trybu HVAC, gdy blokada termostatu jest włączona

Użytkownik musi odblokować termostat, zanim produkt będzie mógł zapisać dane.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie można zmienić trybu HVAC, gdy blokada termostatu jest włączona
`type`	`https://developers.nest.com/reference/error-messages#lock-enabled`
`message`	Nie można zmienić trybu HVAC, gdy blokada termostatu jest włączona

Nie można jednocześnie ustawić temperatur C i F.

Produkt próbował ustawić jednocześnie temperaturę docelową Celsjusza i Fahrenheita. Produkt powinien ustawiać tylko docelową temperaturę określoną przez temperature_scale (C / F).

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie można jednocześnie ustawić temperatur C i F.
`type`	`https://developers.nest.com/reference/error-messages#multiple-value-changes`
`message`	Nie można jednocześnie ustawić temperatur C i F.

Nie można włączyć / wyłączyć fan_timer_active z powodu niezgodnego trybu

Wentylator systemu HVAC jest już włączony (ręcznie przez użytkownika, zgodnie z harmonogramem lub z powodu cyklu ogrzewania / chłodzenia HVAC).

Jeśli nie uzyskasz oczekiwanego wyniku, najprawdopodobniej jest to spowodowane tym, że urządzenie ma wbudowane zachowanie, którego nie możemy zastąpić za pośrednictwem interfejsu API.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie można włączyć / wyłączyć fan_timer_active z powodu niezgodnego trybu `$mode`
`type`	`https://developers.nest.com/reference/error-messages#incompatible-fan-mode`
`message`	Nie można włączyć / wyłączyć fan_timer_active z powodu niezgodnego trybu `$mode`
`details`	`$mode`

Nie można ustawić fan_timer_duration na wybraną wartość

Produkt próbował ustawić fan_timer_duration na nieprawidłową wartość. Zobacz fan_timer_duration aby uzyskać listę prawidłowych wartości.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie można ustawić fan_timer_duration na wybraną wartość. Zobacz dokumentację API dla dozwolonych wartości.
`type`	`https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration`
`message`	Nie można ustawić fan_timer_duration na wybraną wartość. Zobacz dokumentację API dla dozwolonych wartości.

Nie można ustawić docelowej niskiej temperatury wyższej niż docelowa wysoka temperatura

Termostat działa w trybie heat-cool , a produkt próbował ustawić docelową niską / wysoką temperaturę, która jest poza zakresem. Na przykład, produkt próbował ustawić target_temperature_low_c na 25 ° C, gdy target_temperature_high_c wynosi 24 ° C.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie można ustawić docelowej niskiej temperatury `$lowTemp` wyższej niż docelowa wysoka temperatura `$highTemp`
`type`	`https://developers.nest.com/reference/error-messages#low-high-error`
`message`	Nie można ustawić docelowej niskiej temperatury `$lowTemp` wyższej niż docelowa wysoka temperatura `$highTemp`
`details`	`$lowTemp $highTemp`

Nie można ustawić temperatury docelowej bliżej niż N stopni C / F

Produkt próbował ustawić docelową wartość temperatury zbyt blisko docelowej wysokiej / niskiej temperatury (na przykład target_temperature_high_f ).

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie można ustawić temperatury docelowej bliżej niż N stopni C / F
`type`	`https://developers.nest.com/reference/error-messages#range-error`
`message`	Nie można ustawić temperatury docelowej bliżej niż w `$scale` `$min`
`details`	`$min` `$scale`

Nie można ustawić target_temperature, gdy tryb to $ mode

Termostat lub struktura jest obecnie w trybie, który nie obsługuje żądań API.

Na przykład nie można ustawić target_temperature_f ani target_temperature_c gdy system HVAC jest off lub w trybie heat-cool . Wartości nie można zmienić, dopóki termostat / konstrukcja nie przełączy się z powrotem w tryb nieograniczony.

W tym komunikacie $fieldName może być dowolną docelową wartością temperatury, a $mode może być dowolną z następujących wartości: eco , emer_heat_enable , heat-cool , heat , cool , off , hvac_safety_shutoff_active .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie można ustawić target_temperature, gdy tryb to `$mode`
`type`	`https://developers.nest.com/reference/error-messages#mode-error`
`message`	Nie można ustawić `$fieldName` gdy tryb to `$mode`
`details`	`$fieldName $mode`

Przed zmianą trybu HVAC wymagana jest aktualizacja oprogramowania sprzętowego

Urządzenie musi zostać zaktualizowane do aktualnej wersji oprogramowania sprzętowego w celu ustawienia Temperatur Eco.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Przed zmianą trybu HVAC wymagana jest aktualizacja oprogramowania sprzętowego. Aktualizacje są automatyczne, zwykle w ciągu tygodnia od wydania.
`type`	`https://developers.nest.com/reference/error-messages#unsupported-firmware-version`
`message`	Przed zmianą trybu HVAC wymagana jest aktualizacja oprogramowania sprzętowego. Aktualizacje są automatyczne, zwykle w ciągu tygodnia od wydania.

Błąd podczas sprawdzania poprawności pól WWN

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Błąd podczas sprawdzania poprawności pól WWN: `$error`
`type`	`https://developers.nest.com/reference/error-messages#where-id-internal`
`message`	Błąd podczas sprawdzania poprawności pól WWN: `$error`
`details`	`$error`

ETA to przeszłość

Podany czas ETA już minął (przed TERAZ). Aby uzyskać więcej informacji na temat wykonywania połączeń ETA, zobacz Przewodnik po nieobecności i przewidywanym czasie przybycia .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	`$estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime` to przeszłość: `$estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime`
`type`	`https://developers.nest.com/reference/error-messages#eta-in-the-past`
`message`	`$estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime` to przeszłość: `$estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime`
`details`	`$estimatedArrivalTime $currentTime`

ETA to za daleko w przyszłości

Podany czas ETA nie może być dłuższy niż 8 godzin w przyszłości. Aby uzyskać więcej informacji na temat wykonywania połączeń ETA, zobacz Przewodnik po nieobecności i przewidywanym czasie przybycia .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	ETA jest zbyt odległa w przyszłości
`type`	`https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future`
`message`	ETA jest zbyt odległa w przyszłości

fan_timer_active nie jest ustawiony

fan_timer_active nie jest zdefiniowany.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	fan_timer_active nie jest ustawiony
`type`	`https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing`
`message`	fan_timer_active nie jest ustawiony

Zakazana

Poświadczenia używane do uzyskiwania dostępu do usługi Nest są nieprawidłowe.

Parametry
Kod stanu HTTP: 403 zabroniony
`error`	Zakazana
`type`	`https://developers.nest.com/reference/error-messages#forbidden`
`message`	Zakazana

Błąd wewnętrzny

Parametry
Kod stanu HTTP: 500 wewnętrzny błąd serwera
`error`	Błąd wewnętrzny
`type`	`https://developers.nest.com/reference/error-messages#internal-error`
`message`	Błąd wewnętrzny

Nieprawidłowy identyfikator aparatu

camera-id jest nieprawidłowy.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nieprawidłowy identyfikator aparatu `$id`
`type`	`https://developers.nest.com/reference/error-messages#invalid-camera-id`
`message`	Nieprawidłowy identyfikator aparatu: `$id`
`details`	`$id`

Wysłano nieprawidłową treść

Wezwanie zawiera nieprawidłową treść. Na przykład użycie „tak” zamiast „prawda” dla zmiennej boolowskiej.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Wysłano nieprawidłową treść
`type`	`https://developers.nest.com/reference/error-messages#invalid-content-sent`
`message`	Wysłano nieprawidłową treść

Nieprawidłowa ścieżka fragmentu

Część ścieżki żądania jest nieprawidłowa. Na przykład nazwa obiektu lub pola może być błędnie wpisana.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nieprawidłowa ścieżka fragmentu: `$requestPath`
`type`	`https://developers.nest.com/reference/error-messages#invalid-fragment`
`message`	Nieprawidłowa ścieżka fragmentu: `$requestPath`
`details`	`$requestPath`

Nieprawidłowy tryb HVAC

System HVAC termostatu nie obsługuje trybu żądanego przez produkt: heat , cool lub heat-cool .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nieprawidłowy tryb HVAC: `$mode`
`type`	`https://developers.nest.com/reference/error-messages#invalid-mode`
`message`	Nieprawidłowy tryb HVAC: `$mode`
`details`	`$mode`

Nieprawidłowy identyfikator alarmu dymu i współpracy

smoke_co_alarm_id jest nieprawidłowy.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nieprawidłowy identyfikator alarmu dymu i współpracy `$id`
`type`	`https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id`
`message`	Nieprawidłowy identyfikator alarmu dymu + CO: `$id`
`details`	`$id`

Nieprawidłowy identyfikator struktury

Identyfikator structure_id jest nieprawidłowy.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nieprawidłowy identyfikator struktury `$id`
`type`	`https://developers.nest.com/reference/error-messages#invalid-structure-id`
`message`	Nieprawidłowy identyfikator struktury: `$id`
`details`	`$id`

Nieprawidłowy identyfikator termostatu

thermostat_id jest nieprawidłowy.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nieprawidłowy identyfikator termostatu `$id`
`type`	`https://developers.nest.com/reference/error-messages#invalid-thermostat-id`
`message`	Nieprawidłowy identyfikator termostatu: `$id`
`details`	`$id`

Nieprawidłowa wartość dla Poza domem

Próbowałeś ustawić nieprawidłową wartość dla away .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nieprawidłowa wartość dla Poza domem
`type`	`https://developers.nest.com/reference/error-messages#invalid-away-value`
`message`	Nieprawidłowa wartość: `$value` . Dopuszczalnymi wartościami są tylko „dom” i „poza domem”.
`details`	`$value`

is_streaming nie jest wartością logiczną

Produkt próbował ustawić pole is-streaming na wartość inną niż boolowska.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	is_streaming nie jest wartością logiczną
`type`	`https://developers.nest.com/reference/error-messages#invalid-is-stream-format`
`message`	is_streaming nie jest wartością logiczną

Etykieta musi mieć mniej niż 256 znaków

Produkt próbował utworzyć etykietę termostatu zawierającą więcej niż 256 znaków.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Etykieta musi mieć mniej niż `$max_label_length` znaków
`type`	`https://developers.nest.com/reference/error-messages#max-label-length`
`message`	Etykieta musi mieć mniej niż `$max_label_length` znaków
`details`	`$max_label_length`

Maksymalna liczba niestandardowych, w przypadku których przekroczono liczbę

Produkt próbował utworzyć niestandardowy obiekt wheres poza maksimum. Maksymalna dozwolona liczba niestandardowych obiektów wheres to 32.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Maksymalna liczba niestandardowa w przypadku przekroczenia liczby `$max_where_count`
`type`	`https://developers.nest.com/reference/error-messages#max-where-count`
`message`	Maksymalna liczba niestandardowa w przypadku przekroczenia liczby `$max_where_count`
`details`	`$max_where_count`

Maksymalna liczba niestandardowych, gdy przekroczono długość nazwy

name jest za długa. Zalecamy mniej niż 30 znaków.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Maksymalna liczba niestandardowa, `$max_custom_where_name_length` przekroczono długość nazwy `$max_custom_where_name_length`
`type`	`https://developers.nest.com/reference/error-messages#max-where-name-length`
`message`	Maksymalna liczba niestandardowa, `$max_custom_where_name_length` przekroczono długość nazwy `$max_custom_where_name_length`
`details`	`$max_custom_where_name_length`

Brak pola

W wywołaniu brakuje wymaganego parametru.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Brakujące pole: `$fieldName`
`type`	`https://developers.nest.com/reference/error-messages#field-is-missing`
`message`	Brakujące pole: `$fieldName`
`details`	`$fieldName`

Brak identyfikatora Where

where_id formatu where_id .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Brak identyfikatora Where
`type`	`https://developers.nest.com/reference/error-messages#where-id-missing`
`message`	Brak identyfikatora Where

Brak wentylatora HVAC

Wygląda na to, że system HVAC nie ma niezależnego wentylatora.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Brak wentylatora HVAC
`type`	`https://developers.nest.com/reference/error-messages#no-hvac-fan`
`message`	Brak wentylatora HVAC

Brak termostatów online

Termostat jest obecnie offline. Po włączeniu Wi-Fi produkt powinien odzyskać dostęp.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Brak termostatów online
`type`	`https://developers.nest.com/reference/error-messages#no-thermostats-online`
`message`	Brak termostatów online

Brak sparowanych urządzeń

Urządzenia Nest użytkownika nie są sparowane z kontem Nest użytkownika .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Brak sparowanych urządzeń
`type`	`https://developers.nest.com/reference/error-messages#no-paired-devices`
`message`	Brak sparowanych urządzeń

Brak ważnego ETA do anulowania

Podróż jest nieważna i nie można jej anulować.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Brak ważnego ETA do anulowania
`type`	`https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel`
`message`	Brak ważnego ETA do anulowania

Brak uprawnień do zapisu w polu (polach)

Klient nie ma uprawnień do zapisu tych danych. Aby uzyskać więcej informacji, zobacz Omówienie uprawnień .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Brak uprawnień do zapisu dla pola (pól): `$fields`
`type`	`https://developers.nest.com/reference/error-messages#no-write-permission`
`message`	Brak uprawnień do zapisu dla pola (pól): `$fields`
`details`	`$fields`

Nieprawidłowy typ żądania

Typ żądania jest nieprawidłowy. Na przykład wywołanie POST zostało wykonane, gdy wymagane jest PUT.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nieprawidłowy typ żądania: `$requestType`
`type`	`https://developers.nest.com/reference/error-messages#request-type-not-allowed`
`message`	Nieprawidłowy typ żądania: `$requestType`
`details`	`$requestType`

Nie znaleziono

Wywołanie próbowało odczytać ścieżkę, która nie istnieje.

Parametry
Kod stanu HTTP: 404 nie znaleziono
`error`	Nie znaleziono
`type`	`https://developers.nest.com/reference/error-messages#not-found`
`message`	Nie znaleziono

Nie w trybie nieobecności

Struktura nie jest w trybie Poza domem, gdy wykonywane jest wezwanie do ETA. Połączenia ETA są akceptowane tylko wtedy, gdy struktura jest ustawiona na Poza domem.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie w trybie nieobecności
`type`	`https://developers.nest.com/reference/error-messages#not-in-away-mode`
`message`	Nie w trybie nieobecności

Nie do zapisu

Pole, w którym próbujesz pisać, jest tylko do odczytu.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie do zapisu
`type`	`https://developers.nest.com/reference/error-messages#not-writable`
`message`	Nie do zapisu

Tylko tam, gdzie trzeba podać nazwę

Dodatkowe pola zostały uwzględnione w wywołaniu wheres .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Tylko tam, gdzie trzeba podać nazwę
`type`	`https://developers.nest.com/reference/error-messages#extra-fields`
`message`	Tylko tam, gdzie trzeba podać nazwę

POST nie jest prawidłowym typem żądania

Typ żądania jest nieprawidłowy. Na przykład wywołanie POST zostało wykonane, gdy wymagane jest PUT.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	POST nie jest prawidłowym typem żądania
`type`	`https://developers.nest.com/reference/error-messages#invalid-request-type`
`message`	POST nie jest prawidłowym typem żądania

Naruszenie schematu

Wystąpił błąd podczas parowania urządzeń.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Naruszenie schematu
`type`	`https://developers.nest.com/reference/error-messages#schema-violation-error`
`message`	Naruszenie schematu

Serwis niedostępny

Parametry
Kod stanu HTTP: Usługa 503 niedostępna
`error`	serwis niedostępny
`type`	`https://developers.nest.com/reference/error-messages#service-unavailable`
`message`	serwis niedostępny

Struktura ma już maksymalną dozwoloną liczbę sparowanych urządzeń

Struktura ma już maksymalną liczbę dozwolonych urządzeń .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Struktura ma już maksymalną dozwoloną liczbę sparowanych urządzeń
`type`	`https://developers.nest.com/reference/error-messages#max-number-devices-error`
`message`	Struktura ma już maksymalną dozwoloną liczbę sparowanych urządzeń

Struktura nie jest własnością użytkownika

structure_id nie pasuje do konta użytkownika rekordu.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Struktura nie jest własnością użytkownika.
`type`	`https://developers.nest.com/reference/error-messages#structure-ownership-error-uri`
`message`	Struktura nie jest własnością użytkownika.

Temperatura C jest zbyt wysoka dla temperatury zamka

Termostat został zablokowany przez użytkownika, a produkt próbował ustawić docelową temperaturę w stopniach Celsjusza wyższą niż zakres temperatury blokady.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Temperatura C `$tempC` jest zbyt wysoka dla temperatury blokady `$highLockTemp`
`type`	`https://developers.nest.com/reference/error-messages#high-c-value-4-lock`
`message`	Temperatura C `$tempC` jest zbyt wysoka dla temperatury blokady `$highLockTemp`
`details`	`$tempC $highLockTemp`

Temperatura C jest zbyt niska dla temperatury zamka

Termostat został zablokowany przez użytkownika, a produkt próbował ustawić docelową temperaturę w stopniach Celsjusza niższą niż zakres temperatury blokady.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Temperatura C `$tempC` jest zbyt niska dla temperatury blokady `$lowLockTemp`
`type`	`https://developers.nest.com/reference/error-messages#low-c-value-4-lock`
`message`	Temperatura C `$tempC` jest zbyt niska dla temperatury blokady `$lowLockTemp`
`details`	`$tempC $lowLockTemp`

Wartość temperatury C jest zbyt wysoka

Produkt próbował ustawić docelową wartość temperatury, która jest zbyt wysoka dla temperatury Celsjusza. Aby zapoznać się z dozwolonymi zakresami temperatur w stopniach Celsjusza, patrz target_temperature_c .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Wartość temperatury C jest zbyt wysoka: `$tempC`
`type`	`https://developers.nest.com/reference/error-messages#high-c-value`
`message`	Wartość temperatury C jest zbyt wysoka: `$tempC`
`details`	`$tempC`

Wartość temperatury C jest za niska

Produkt próbował ustawić docelową wartość temperatury, która jest zbyt niska dla temperatury Celsjusza. Aby zapoznać się z dozwolonymi zakresami temperatur w stopniach Celsjusza, patrz target_temperature_c .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Wartość temperatury C jest zbyt niska: `$tempC`
`type`	`https://developers.nest.com/reference/error-messages#low-c-value`
`message`	Wartość temperatury C jest zbyt niska: `$tempC`
`details`	`$tempC`

Temperatura F jest zbyt wysoka dla temperatury zamka

Użytkownik zablokował termostat i produkt próbował ustawić docelową temperaturę w stopniach Fahrenheita wyższą niż zakres temperatury blokady.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Temperatura F `$tempF` jest zbyt wysoka dla temperatury blokady `$highLockTemp`
`type`	`https://developers.nest.com/reference/error-messages#high-f-value-4-lock`
`message`	Temperatura F `$tempF` jest zbyt wysoka dla temperatury blokady `$highLockTemp`
`details`	`$tempF $highLockTemp`

Temperatura F jest zbyt niska dla temperatury zamka

Użytkownik zablokował termostat, a produkt próbował ustawić docelową temperaturę w stopniach Fahrenheita niższą niż zakres temperatury blokady.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Temperatura F `$tempF` jest zbyt niska dla temperatury blokady `$lowLockTemp`
`type`	`https://developers.nest.com/reference/error-messages#low-f-value-4-lock`
`message`	Temperatura F `$tempF` jest zbyt niska dla temperatury blokady `$lowLockTemp`
`details`	`$tempF $lowLockTemp`

Wartość temperatury F jest zbyt wysoka

Produkt próbował ustawić docelową wartość temperatury, która jest zbyt wysoka dla temperatury Fahrenheita. Aby zapoznać się z dozwolonymi zakresami temperatur w stopniach Fahrenheita, patrz target_temperature_f .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Wartość temperatury F jest zbyt wysoka: `$tempF`
`type`	`https://developers.nest.com/reference/error-messages#high-f-value`
`message`	Wartość temperatury F jest zbyt wysoka: `$tempF`
`details`	`$tempF`

Wartość temperatury F jest zbyt niska

Produkt próbował ustawić docelową wartość temperatury, która jest zbyt niska dla temperatury Fahrenheita. Aby zapoznać się z dozwolonymi zakresami temperatur w stopniach Fahrenheita, patrz target_temperature_f .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Wartość temperatury F jest zbyt niska: `$tempF`
`type`	`https://developers.nest.com/reference/error-messages#low-f-value`
`message`	Wartość temperatury F jest zbyt niska: `$tempF`
`details`	`$tempF`

Temperatura jest w złym formacie

Produkt próbował ustawić temperaturę docelową przy użyciu nieprawidłowego formatu liczbowego dla wybranej temperature_scale . Temperatury Celsjusza powinny być liczbami całkowitymi z przyrostem 0,5 stopnia (21,5), a temperatury Fahrenheita powinny być liczbami całkowitymi (72).

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Temperatura `$temp` ma niewłaściwy format
`type`	`https://developers.nest.com/reference/error-messages#format-error`
`message`	Temperatura `$temp` ma niewłaściwy format
`details`	`$temp`

Pola nie można modyfikować podczas aktualizacji

Produkt podjął próbę zapisu w polu tylko do odczytu.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie można modyfikować `$fieldNames` podczas aktualizacji: `$fieldNames`
`type`	`https://developers.nest.com/reference/error-messages#read-only-field-error`
`message`	Nie można modyfikować `$fieldNames` podczas aktualizacji: `$fieldNames`
`details`	`$fieldNames`

Pola powinny mieć format ISO 8601

Pole nie jest w formacie ISO 8601 .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Pola powinny mieć format ISO 8601: `$fieldNames`
`type`	`https://developers.nest.com/reference/error-messages#time-format-error`
`message`	Pola powinny mieć format ISO 8601: `$fieldNames`
`details`	`$fieldNames`

Termostat nie jest online

Termostat jest obecnie offline. Po włączeniu Wi-Fi produkt powinien odzyskać dostęp.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Termostat nie jest online
`type`	`https://developers.nest.com/reference/error-messages#not-online`
`message`	Termostat nie jest online

Ta podróż została zastąpiona ręcznie

Użytkownik ręcznie zmienił trasę.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Ta podróż została zastąpiona ręcznie
`type`	`https://developers.nest.com/reference/error-messages#trip-manually-overidden`
`message`	Ta podróż została zastąpiona ręcznie

Nie można utworzyć, gdzie ID

Brakuje obiektu wheres . Nie where_id żadnych wartości where_id .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nie można utworzyć, gdzie id
`type`	`https://developers.nest.com/reference/error-messages#wheres-missing`
`message`	Nie można utworzyć, gdzie id

Nieautoryzowany

Autoryzacja nie powiodła się.

Kilka warunków może spowodować wygenerowanie tego komunikatu o błędzie:

niepoprawne przekierowania, które występują, gdy dana implementacja HTTP nie przekazuje automatycznie nagłówka Authorization do przekierowanego identyfikatora URI. Aby uzyskać więcej informacji, zobacz jak obsługiwać przekierowania .
nieprawidłowe uprawnienia podczas próby uzyskania dostępu do punktów końcowych interfejsu API. Na przykład próba odczytania punktu końcowego termostatu, gdy dla klienta są wybrane tylko uprawnienia kamery. Aby uzyskać więcej informacji, zobacz Jak wybrać uprawnienia .

Parametry
Kod stanu HTTP: 401 Brak autoryzacji
`error`	Nieautoryzowany
`type`	`https://developers.nest.com/reference/error-messages#auth-error`
`message`	Nieautoryzowany

Nieznany

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	nieznany
`type`	`https://developers.nest.com/reference/error-messages#unknown`
`message`	nieznany

Nieznany dostawca / typ urządzenia

Dostawca / urządzenie nie zostało rozpoznane podczas parowania urządzenia.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Nieznany dostawca / typ urządzenia
`type`	`https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error`
`message`	Nieznany dostawca / typ urządzenia

Wartość $ fieldName jest niewłaściwego typu

Wysłano nieprawidłowy typ danych. Na przykład wysyłanie łańcucha, gdy oczekiwana jest wartość logiczna.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Wartość `$fieldName` jest niewłaściwego typu
`type`	`https://developers.nest.com/reference/error-messages#wrong-data-type`
`message`	Wartość `$fieldName` jest niewłaściwego typu
`details`	`$fieldName`

Gdzie nazwa już istnieje

Nazwa where_name którą produkt próbował ustawić, już istnieje. Spróbuj ponownie, podając nową nazwę.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Gdzie nazwa `$name` już istnieje
`type`	`https://developers.nest.com/reference/error-messages#where-name-exists`
`message`	Gdzie nazwa `$name` już istnieje
`details`	`$name`

Gdzie nie podano nazwy

W where_name brakuje where_name .

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Gdzie nie podano nazwy
`type`	`https://developers.nest.com/reference/error-messages#where-name-missing`
`message`	Gdzie nie podano nazwy

Gdzie nazwa ma zerową długość

Gdzie name nie jest zdefiniowana (ma zero znaków).

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Gdzie nazwa ma zerową długość
`type`	`https://developers.nest.com/reference/error-messages#zero-length-where-name`
`message`	Gdzie nazwa ma zerową długość

Gdzie nazwa musi być ciągiem

Wysłano nieprawidłowy typ danych dla parametru where_name . Na przykład liczba, gdy oczekiwany jest ciąg.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	Gdzie nazwa musi być ciągiem
`type`	`https://developers.nest.com/reference/error-messages#where-name-wrong-format`
`message`	Gdzie nazwa musi być ciągiem

where_id nie istnieje

where_id jest nieprawidłowy.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	where_id nie istnieje
`type`	`https://developers.nest.com/reference/error-messages#where-id-invalid`
`message`	where_id nie istnieje
`details`	`$where_id`

gdzie_id musi być ciągiem

Format where_id jest nieprawidłowy. Na przykład zamiast ciągu wysłana została liczba.

Parametry
Kod stanu HTTP: 400 błędne żądanie
`error`	gdzie_id musi być ciągiem
`type`	`https://developers.nest.com/reference/error-messages#where-id-wrong-format`
`message`	gdzie_id musi być ciągiem

Inne kody i komunikaty błędów

Kody błędów urządzenia

Aby zapoznać się z kodami błędów i komunikatami dotyczącymi poszczególnych urządzeń, które nie są związane z interfejsem Nest API, zobacz:

Kody błędów REST

Podczas wykonywania wywołania interfejsu API REST zwracane są typowe kody stanu HTTP.

Komunikaty o limitach szybkości REST

Podczas korzystania z REST i wysyłania zbyt wielu wywołań w krótkim czasie możesz otrzymać kod stanu odpowiedzi HTTP o wartości 429 Zbyt wiele żądań.

Aby uzyskać więcej informacji, zobacz Limity szybkości transmisji danych .