Google jest zaangażowany w promowanie równości rasowej dla społeczności czarnych. Zobacz jak.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

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 niesparowane 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 .