Komunikaty o błędach

Warunki błędów są częścią cyklu programowania i mogą mieć postać od prostych błędów, takich jak nieprawidłowy czy brakujący parametr, po bardziej złożone scenariusze, takie jak nieoczekiwany stan czy nawet ustawienia związane z urządzeniem, które trzeba rozwiązać poza interfejsem API.

Gdy podczas wywołania interfejsu API wystąpi błąd, zostanie wysłana odpowiedź w tym 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. Obiekt details jest opcjonalny.

Pole Opis
error Krótki format komunikatu o błędzie.
type Podaje adres URL zawierający szczegółowe informacje o stanie błędu (ta strona).
message Długi komunikat o błędzie, w którym zmienne mogą służyć do podawania dodatkowych informacji. Jeśli w wiadomości znajduje się zmienna, pojawi się ona w obiekcie details.
instance Ciąg tekstowy zawierający identyfikator błędu, który jest unikalny dla każdego wywołania. Jeśli wystąpią problemy z usługą, możemy poprosić Cię o podanie numeru instancji.
details Opcjonalnie: Zawiera zmienne wstawione do message. Wiadomości mogą zawierać wiele zmiennych.

Informacje o błędach niezwiązanych z interfejsem Nest API znajdziesz w artykule Inne kody błędów i komunikaty.

Zablokowano

Limit szybkości został przekroczony.

Parametry
Kod stanu HTTP: 429 Zbyt wiele żądań
errorZablokowano
typehttps://developers.nest.com/reference/error-messages#blocked
messageZablokowano

Nie można włączyć wentylatora w momencie wyłączenia dymu/bezpieczeństwa

Wyłączenie alarmowe jest już aktywne. Wywołania interfejsu API nie są obsługiwane, dopóki nie zostanie przywrócone normalne działanie.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNie można włączyć wentylatora w momencie wyłączenia dymu/bezpieczeństwa
typehttps://developers.nest.com/reference/error-messages#safety-shutoff-on
messageNie można włączyć wentylatora w momencie wyłączenia dymu/bezpieczeństwa

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

Produkt próbował zmienić stan Poza domem, gdy włączony był tryb grzania.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNie można zmienić stanu Poza domem, gdy ogrzewanie awaryjne jest włączone
typehttps://developers.nest.com/reference/error-messages#emergency-heat-is-on
messageNie można zmienić stanu Poza domem, gdy ogrzewanie awaryjne jest włączone

Nie można zmienić trybu ogrzewania/wentylacji/klimatyzacji podczas oszczędzania energii

Obecnie obowiązuje zdarzenie oszczędzania energii zdefiniowane przez partnera Nest. Wywołania interfejsu API będą odrzucane do zakończenia zdarzenia oszczędzania energii.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNie można zmienić trybu ogrzewania/wentylacji/klimatyzacji podczas oszczędzania energii
typehttps://developers.nest.com/reference/error-messages#energy-saving-event-on
messageNie można zmienić trybu ogrzewania/wentylacji/klimatyzacji podczas oszczędzania energii

Nie można zmienić trybu ogrzewania/wentylacji/klimatyzacji

Tryb jest niezgodny z żądaniem.

Ten komunikat może się pojawić na przykład, jeśli:

  • System ogrzewania/wentylacji/klimatyzacji termostatu nie obsługuje trybu żądanego przez Twój produkt: heat, cool, heat-cool lub eco
  • Tryb ogrzewania, wentylacji i klimatyzacji jest ustawiony na eco, a usługa próbuje ustawić target_temperature
Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNie można zmienić trybu ogrzewania/wentylacji/klimatyzacji na $mode; HVAC nie może $action
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
messageNie można zmienić trybu ogrzewania/wentylacji/klimatyzacji na $mode; HVAC nie może $action
details$mode
$action

Nie można zmienić trybu ogrzewania/wentylacji/klimatyzacji przy włączonej blokady termostatu

Aby produkt mógł zapisywać dane, użytkownik musi go odblokować.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNie można zmienić trybu ogrzewania/wentylacji/klimatyzacji przy włączonej blokady termostatu
typehttps://developers.nest.com/reference/error-messages#lock-enabled
messageNie można zmienić trybu ogrzewania/wentylacji/klimatyzacji przy włączonej blokady termostatu

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

Produkt próbował ustawić wartości docelowe Celsjusza i Fahrenheita w tym samym czasie. Produkt powinien ustawić tylko temperaturę docelową określoną przez temperature_scale (C/F).

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNie można ustawić temperatury C i F jednocześnie
typehttps://developers.nest.com/reference/error-messages#multiple-value-changes
messageNie można ustawić temperatury C i F jednocześnie

Nie można włączyć ani wyłączyć ustawienia Fan_timer_active z powodu niezgodnego trybu

Wentylator systemu HVAC jest już zaangażowany (ręcznie lub według harmonogramu albo z powodu ogrzewania/chłodzenia ogrzewania/wentylacji/klimatyzacji).

Jeśli nie otrzymasz oczekiwanego wyniku, najprawdopodobniej urządzenie ma wbudowane zachowanie, którego nie można zastąpić za pomocą interfejsu API.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNie można włączyć ani wyłączyć ustawienia Fan_timer_active z powodu niezgodnego trybu $mode
typehttps://developers.nest.com/reference/error-messages#incompatible-fan-mode
messageNie można włączyć ani wyłączyć ustawienia Fan_timer_active z powodu niezgodnego trybu $mode
details$mode

Nie można ustawić wartości Fan_timer_duration na wybraną wartość

Usługa próbowała ustawić nieprawidłową wartość fan_timer_duration. Listę prawidłowych wartości znajdziesz w fan_timer_duration.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNie można ustawić wartości Fan_timer_duration na wybraną wartość. Dozwolone wartości znajdziesz w dokumentacji API.
typehttps://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
messageNie można ustawić wartości Fan_timer_duration na wybraną wartość. Dozwolone wartości znajdziesz w dokumentacji API.

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

Termostat działa w trybie heat-cool, a produkt próbował ustawić niską lub wysoką temperaturę docelową poza zakresem. Na przykład wartość atrybutu target_temperature_low_c dla produktu zostanie ustawiona na 25°C, gdy target_temperature_high_c wynosi 24°C.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNie można ustawić niskiej temperatury docelowej $lowTemp wyższej niż docelowa temperatura maksymalna $highTemp
typehttps://developers.nest.com/reference/error-messages#low-high-error
messageNie można ustawić niskiej temperatury docelowej $lowTemp wyższej niż docelowa temperatura maksymalna $highTemp
details$lowTemp
$highTemp

Nie można ustawić temperatury docelowej wyższej niż N stopni/C

Produkt próbował ustawić wartość temperatury docelowej zbyt blisko docelowej lub niskiej temperatury (np. target_temperature_high_f).

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNie można ustawić temperatury docelowej wyższej niż N stopni/C
typehttps://developers.nest.com/reference/error-messages#range-error
messageNie można ustawić temperatury docelowej poniżej $min stopni $scale
details$min
$scale

Nie można ustawić wartości docelowej_temperatura, gdy tryb jest w trybie $mode

Termostat lub struktura mają obecnie tryb, który nie obsługuje żądań do interfejsu API.

Na przykład nie można ustawić wartości target_temperature_f ani target_temperature_c, gdy system ogrzewania/wentylacji/klimatyzacji jest ustawiony na off lub heat-cool. Wartość nie może zostać zmieniona, dopóki termostat/struktura nie przełączy się z powrotem na tryb ograniczonego dostępu.

W tej wiadomości $fieldName może być dowolną z docelowych wartości temperatury,a $mode może być dowolną z tych wartości: eco, emer_heat_enable, heat-cool, heat, cool, off, hvac_safety_shutoff_active.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNie można ustawić wartości docelowej_temperatura, gdy tryb jest $mode
typehttps://developers.nest.com/reference/error-messages#mode-error
messageNie można ustawić zasady $fieldName, gdy tryb jest $mode
details$fieldName
$mode

Przed zmianą trybu ogrzewania/wentylacji/klimatyzacji musisz zaktualizować oprogramowanie układowe urządzenia

Aby ustawić temperatury w trybie Eko, musisz zaktualizować urządzenie do bieżącej wersji oprogramowania.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorPrzed zmianą trybu ogrzewania/wentylacji/klimatyzacji musisz zaktualizować oprogramowanie układowe urządzenia. Aktualizacje są automatyczne, zazwyczaj w ciągu tygodnia od wydania.
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
messagePrzed zmianą trybu ogrzewania/wentylacji/klimatyzacji musisz zaktualizować oprogramowanie układowe urządzenia. Aktualizacje są automatyczne, zazwyczaj w ciągu tygodnia od wydania.

Podczas weryfikowania pól WWN wystąpił błąd

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorPodczas weryfikowania pól WWN wystąpił błąd: $error
typehttps://developers.nest.com/reference/error-messages#where-id-internal
messagePodczas weryfikowania pól WWN wystąpił błąd: $error
details$error

Szacowany czas dotarcia przypada w przeszłości

Podany szacowany czas dotarcia na miejsce przypada w przeszłości (przed NOW). Więcej informacji o wykonywaniem połączeń z szacowanym czasem dotarcia znajdziesz w przewodniku Poza domem z szacowanym czasem dotarcia na miejsce.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorSzacowany czas dotarcia przypada w przeszłości: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
typehttps://developers.nest.com/reference/error-messages#eta-in-the-past
messageSzacowany czas dotarcia przypada w przeszłości: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details$estimatedArrivalTime
$currentTime

Szacowany szacowany czas dotarcia w przyszłości jest odległy w przyszłości

Szacowany czas dotarcia na miejsce nie może przypadać później niż 8 godzin w przyszłości. Więcej informacji o wykonywaniu połączeń z szacowanym czasem dotarcia znajdziesz w przewodniku Poza domem z szacowanym czasem dotarcia.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorSzacowany czas dotarcia na przyszłość jest zbyt odległy
typehttps://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
messageSzacowany czas dotarcia na przyszłość jest zbyt odległy

Parametr fan_timer_active nie jest ustawiony

fan_timer_active nie jest zdefiniowany.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorParametr fan_timer_active nie jest ustawiony
typehttps://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
messageParametr fan_timer_active nie jest ustawiony

Zabroniono

Dane logowania używane do uzyskania dostępu do usługi Nest są nieprawidłowe.

Parametry
Kod stanu HTTP: 403 Forbidden
errorZabroniono
typehttps://developers.nest.com/reference/error-messages#forbidden
messageZabroniono

Błąd wewnętrzny

Parametry
HTTP Status Code: 500 Internal Server Error (Wewnętrzny błąd serwera)
errorBłąd wewnętrzny
typehttps://developers.nest.com/reference/error-messages#internal-error
messageBłąd wewnętrzny

Nieprawidłowy identyfikator kamery

Element camera-id jest nieprawidłowy.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNieprawidłowy identyfikator kamery $id
typehttps://developers.nest.com/reference/error-messages#invalid-camera-id
messageNieprawidłowy identyfikator kamery: $id
details$id

Wysłano nieprawidłową treść

Wywołanie zawiera nieprawidłową treść. np. "yes" zamiast zmiennej quot;true" dla zmiennej logicznej.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorWysłano nieprawidłową treść
typehttps://developers.nest.com/reference/error-messages#invalid-content-sent
messageWysł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 zostać błędnie wpisana.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNieprawidłowa ścieżka fragmentu: $requestPath
typehttps://developers.nest.com/reference/error-messages#invalid-fragment
messageNieprawidłowa ścieżka fragmentu: $requestPath
details$requestPath

Nieprawidłowy tryb ogrzewania/wentylacji/klimatyzacji

System ogrzewania/wentylacji/klimatyzacji termostatu nie obsługuje trybu żądanego przez tę usługę: heat, cool lub heat-cool.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNieprawidłowy tryb ogrzewania/wentylacji/klimatyzacji: $mode
typehttps://developers.nest.com/reference/error-messages#invalid-mode
messageNieprawidłowy tryb ogrzewania/wentylacji/klimatyzacji: $mode
details$mode

Nieprawidłowy identyfikator alarmu z czujnika dymu i tlenku węgla

Element smoke_co_alarm_id jest nieprawidłowy.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNieprawidłowy identyfikator alarmu z czujnika dymu + co $id
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
messageNieprawidłowy identyfikator alarmu z czujnika dymu + co: $id
details$id

Nieprawidłowy identyfikator struktury

Element structure_id jest nieprawidłowy.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNieprawidłowy identyfikator struktury $id
typehttps://developers.nest.com/reference/error-messages#invalid-structure-id
messageNieprawidłowy identyfikator struktury: $id
details$id

Nieprawidłowy identyfikator termostatu

Element thermostat_id jest nieprawidłowy.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNieprawidłowy identyfikator termostatu: $id
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
messageNieprawidłowy identyfikator termostatu: $id
details$id

Nieprawidłowa wartość Nieobecność

Próbujesz ustawić nieprawidłową wartość away.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNieprawidłowa wartość Nieobecność
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
messageNieprawidłowa wartość: $value. Dozwolone są tylko wartości 'home' &&33;away&#39.
details$value

is_streaming nie jest wartością logiczną

Usługa próbowała ustawić pole is-streaming jako niewartość logiczną.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
erroris_streaming nie jest wartością logiczną
typehttps://developers.nest.com/reference/error-messages#invalid-is-stream-format
messageis_streaming nie jest wartością logiczną

Etykieta musi mieć mniej niż 256 znaków

Produkt próbował utworzyć etykietę termostatu zawierającą ponad 256 znaków.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorEtykieta musi mieć mniej znaków niż $max_label_length
typehttps://developers.nest.com/reference/error-messages#max-label-length
messageEtykieta musi mieć mniej znaków niż $max_label_length
details$max_label_length

Maksymalna liczba niestandardowych miejsc, w których przekroczono liczbę elementów

Usługa próbowała utworzyć niestandardowy obiekt wheres ponad wartość maksymalną. Maksymalna dozwolona liczba niestandardowych obiektów wheres to 32.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorMaksymalne ustawienie niestandardowe, w którym przekroczono liczbę zdarzeń „$max_where_count
typehttps://developers.nest.com/reference/error-messages#max-where-count
messageMaksymalne ustawienie niestandardowe, w którym przekroczono liczbę zdarzeń „$max_where_count
details$max_where_count

Maksymalna niestandardowa wartość w miejscu, w którym długość nazwy przekracza

Wartość name jest za długa. Zalecamy stosowanie mniej niż 30 znaków.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorMaksymalna niestandardowa wartość, w której przekroczyła długość $max_custom_where_name_length
typehttps://developers.nest.com/reference/error-messages#max-where-name-length
messageMaksymalna niestandardowa wartość, w której przekroczyła długość $max_custom_where_name_length
details$max_custom_where_name_length

Brakujące pole

W wywołaniu brakuje wymaganego parametru.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorBrak pola: $fieldName
typehttps://developers.nest.com/reference/error-messages#field-is-missing
messageBrak pola: $fieldName
details$fieldName

Brak identyfikatora „Gdzie”

Brak formatu where_id.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorBrak identyfikatora „Gdzie”
typehttps://developers.nest.com/reference/error-messages#where-id-missing
messageBrak identyfikatora „Gdzie”

Brak wentylatora HVAC

Wygląda na to, że system ogrzewania/wentylacji/klimatyzacji nie ma niezależnego wentylatora.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorBrak wentylatora ogrzewania/wentylacji/klimatyzacji
typehttps://developers.nest.com/reference/error-messages#no-hvac-fan
messageBrak wentylatora ogrzewania/wentylacji/klimatyzacji

Brak termostatów online

Termostat jest obecnie offline. Po włączeniu Wi-Fi usługa powinna odzyskać dostęp.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorBrak termostatów online
typehttps://developers.nest.com/reference/error-messages#no-thermostats-online
messageBrak termostatów online

Brak sparowanych urządzeń

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

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorBrak sparowanych urządzeń
typehttps://developers.nest.com/reference/error-messages#no-paired-devices
messageBrak sparowanych urządzeń

Brak prawidłowego szacowanego czasu dotarcia do anulowania

Ta podróż jest nieprawidłowa i nie można jej anulować.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorBrak prawidłowego szacowanego czasu dotarcia do anulowania
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageBrak prawidłowego szacowanego czasu dotarcia do anulowania

Brak uprawnień do zapisu w polach

Klient nie ma uprawnień do zapisu tych danych. Więcej informacji znajdziesz w omówieniu uprawnień.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorBrak uprawnień do zapisu w tych polach: $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
messageBrak uprawnień do zapisu w tych polach: $fields
details$fields

Nieprawidłowy typ żądania

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

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNieprawidłowy typ żądania: $requestType
typehttps://developers.nest.com/reference/error-messages#request-type-not-allowed
messageNieprawidłowy typ żądania: $requestType
details$requestType

Nie znaleziono

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

Parametry
HTTP Status Code: 404 – nie znaleziono
errorNie znaleziono
typehttps://developers.nest.com/reference/error-messages#not-found
messageNie znaleziono

Poza trybem Poza domem

Budynek nie jest w trybie Poza domem podczas wykonywania wywołania szacowanego czasu dotarcia. Wywołania ETA są obsługiwane tylko wtedy, gdy struktura jest ustawiona na Poza domem.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorPoza trybem Poza domem
typehttps://developers.nest.com/reference/error-messages#not-in-away-mode
messagePoza trybem Poza domem

Brak możliwości zapisu

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

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorBrak możliwości zapisu
typehttps://developers.nest.com/reference/error-messages#not-writable
messageBrak możliwości zapisu

Tylko tam, gdzie trzeba podać nazwę

W wywołaniu wheres uwzględniono dodatkowe pola.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorTylko tam, gdzie trzeba podać nazwę
typehttps://developers.nest.com/reference/error-messages#extra-fields
messageTylko 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 wymagany jest plik PUT.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorPOST nie jest prawidłowym typem żądania
typehttps://developers.nest.com/reference/error-messages#invalid-request-type
messagePOST nie jest prawidłowym typem żądania

Naruszenie schematu

Podczas parowania urządzeń wystąpił błąd.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNaruszenie schematu
typehttps://developers.nest.com/reference/error-messages#schema-violation-error
messageNaruszenie schematu

Usługa niedostępna

Parametry
Kod stanu HTTP: Usługa 503 niedostępna
errorUsługa niedostępna
typehttps://developers.nest.com/reference/error-messages#service-unavailable
messageUsługa niedostępna

W strukturze jest już maksymalna dozwolona liczba sparowanych urządzeń

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

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorW strukturze jest już maksymalna dozwolona liczba sparowanych urządzeń
typehttps://developers.nest.com/reference/error-messages#max-number-devices-error
messageW strukturze jest już maksymalna dozwolona liczba sparowanych urządzeń

Struktura nie należy do użytkownika

structure_id nie pasuje do zarejestrowanego konta użytkownika.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorStruktura nie należy do użytkownika.
typehttps://developers.nest.com/reference/error-messages#structure-ownership-error-uri
messageStruktura nie należy do użytkownika.

Temperatura C jest zbyt wysoka, aby zablokować temperaturę

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

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorTemperatura C $tempC jest za wysoka dla temperatury blokady $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-c-value-4-lock
messageTemperatura C $tempC jest za wysoka dla temperatury blokady $highLockTemp
details$tempC
$highLockTemp

Temperatura C jest za niska do temperatury blokady

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

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorTemperatura C $tempC jest za niska dla temperatury blokady $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-c-value-4-lock
messageTemperatura C $tempC jest za niska dla temperatury blokady $lowLockTemp
details$tempC
$lowLockTemp

Wartość temperatury C jest zbyt wysoka

Produkt próbował ustawić wartość temperatury docelowej, która jest za wysoka dla temperatury Celsjusza. Dozwolone zakresy temperatury w stopniach Celsjusza znajdziesz w sekcji target_temperature_c.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorWartość temperatury C jest zbyt wysoka: $tempC
typehttps://developers.nest.com/reference/error-messages#high-c-value
messageWartość temperatury C jest zbyt wysoka: $tempC
details$tempC

Wartość temperatury C jest zbyt niska

Produkt próbował ustawić zbyt niską wartość temperatury docelowej stopni Celsjusza. Dozwolone zakresy temperatury w stopniach Celsjusza znajdziesz w sekcji target_temperature_c.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorWartość temperatury C jest zbyt niska: $tempC
typehttps://developers.nest.com/reference/error-messages#low-c-value
messageWartość temperatury C jest zbyt niska: $tempC
details$tempC

Temperatura F jest zbyt wysoka, aby zablokować temperaturę

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

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorTemperatura F $tempF jest za wysoka dla temperatury blokady $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-f-value-4-lock
messageTemperatura F $tempF jest za wysoka dla temperatury blokady $highLockTemp
details$tempF
$highLockTemp

Temperatura F jest za niska dla temperatury blokady

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

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorTemperatura F $tempF jest za niska, aby temperatura blokady $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-f-value-4-lock
messageTemperatura F $tempF jest za niska, aby temperatura blokady $lowLockTemp
details$tempF
$lowLockTemp

Wartość temperatury F jest zbyt wysoka

Produkt próbował ustawić wartość temperatury docelowej, która jest za wysoka dla stopni Fahrenheita. Dozwolone zakresy temperatury w stopniach Fahrenheita znajdziesz na stronie target_temperature_f.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorWartość temperatury F jest zbyt wysoka: $tempF
typehttps://developers.nest.com/reference/error-messages#high-f-value
messageWartość temperatury F jest zbyt wysoka: $tempF
details$tempF

Wartość temperatury F jest zbyt niska

Produkt próbował ustawić wartość temperatury docelowej za niską dla temperatury Fahrenheita. Dozwolone zakresy temperatury w stopniach Fahrenheita znajdziesz na stronie target_temperature_f.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorWartość temperatury F jest zbyt niska: $tempF
typehttps://developers.nest.com/reference/error-messages#low-f-value
messageWartość temperatury F jest zbyt niska: $tempF
details$tempF

Temperatura jest w niewłaściwym formacie

Produkt próbował ustawić temperaturę docelową w niewłaściwym formacie liczbowym dla wybranego elementu temperature_scale. Temperatury Celsjusza muszą być liczbami całkowitymi w przyrostach co 0,5 stopnia (21,5), a temperatury w stopniach Fahrenheita powinny być liczbą całkowitą (72).

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorTemperatura $temp ma nieprawidłowy format
typehttps://developers.nest.com/reference/error-messages#format-error
messageTemperatura $temp ma nieprawidłowy format
details$temp

Nie można zmodyfikować pól

Usługa próbowała zapisać dane w polu tylko do odczytu.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorTych pól nie można zmieniać podczas aktualizacji: $fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
messageTych pól nie można zmieniać podczas aktualizacji: $fieldNames
details$fieldNames

Pola powinny używać formatu ISO 8601

To pole nie jest w formacie ISO 8601.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorPola powinny używać formatu ISO 8601: $fieldNames
typehttps://developers.nest.com/reference/error-messages#time-format-error
messagePola powinny używać formatu ISO 8601: $fieldNames
details$fieldNames

Termostat nie jest online

Termostat jest obecnie offline. Po włączeniu Wi-Fi usługa powinna odzyskać dostęp.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorTermostat nie jest online
typehttps://developers.nest.com/reference/error-messages#not-online
messageTermostat nie jest online

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

Użytkownik ręcznie zastąpił podróż.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorTa podróż została zastąpiona ręcznie
typehttps://developers.nest.com/reference/error-messages#trip-manually-overidden
messageTa podróż została zastąpiona ręcznie

Nie udało się utworzyć miejsca, w którym ID

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

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNie można utworzyć, gdzie jest identyfikator
typehttps://developers.nest.com/reference/error-messages#wheres-missing
messageNie można utworzyć, gdzie jest identyfikator

Brak autoryzacji

Autoryzacja się nie udała.

Ten komunikat o błędzie może wygenerować kilka warunków:

  • nieprawidłowe przekierowania, które występują, gdy dana implementacja HTTP nie przekierowuje automatycznie nagłówka autoryzacji do przekierowującego identyfikatora URI. Więcej informacji znajdziesz w artykule 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 po wybraniu dla klienta tylko uprawnień do aparatu. Więcej informacji znajdziesz w artykule Jak wybrać uprawnienia.

Parametry
Kod stanu HTTP: 401 Brak autoryzacji
errorBrak autoryzacji
typehttps://developers.nest.com/reference/error-messages#auth-error
messageBrak autoryzacji

Nieznany

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errornieznany
typehttps://developers.nest.com/reference/error-messages#unknown
messagenieznany

Nieznany typ dostawcy/urządzenia

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

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorNieznany typ dostawcy/urządzenia
typehttps://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
messageNieznany typ dostawcy/urządzenia

Wartość pola $fieldName jest nieprawidłowego typu

Wysłano niewłaściwy typ danych. Na przykład wysłanie ciągu znaków, gdy spodziewana jest wartość logiczna.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorWartość $fieldName ma niewłaściwy typ
typehttps://developers.nest.com/reference/error-messages#wrong-data-type
messageWartość $fieldName ma niewłaściwy typ
details$fieldName

Miejsce już istnieje

Atrybut where_name, który próbujesz ustawić, już istnieje. Użyj innej nazwy.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorMiejsce o nazwie $name już istnieje
typehttps://developers.nest.com/reference/error-messages#where-name-exists
messageMiejsce o nazwie $name już istnieje
details$name

Gdzie nie podano nazwy

W rozmowie brakuje elementu where_name.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorGdzie nie podano nazwy
typehttps://developers.nest.com/reference/error-messages#where-name-missing
messageGdzie nie podano nazwy

Gdzie nazwa ma wartość zero

gdzie name nie jest określony (ma zero znaków).

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorGdzie nazwa ma wartość zero
typehttps://developers.nest.com/reference/error-messages#zero-length-where-name
messageGdzie nazwa ma wartość zero

Gdzie nazwa musi być ciągiem znaków

where_name zawiera nieprawidłowy typ danych. Na przykład jest to liczba, której ciąg powinien być oczekiwany.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorGdzie nazwa musi być ciągiem znaków
typehttps://developers.nest.com/reference/error-messages#where-name-wrong-format
messageGdzie nazwa musi być ciągiem znaków

gdzie_identyfikator nie istnieje

Element where_id jest nieprawidłowy.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorgdzie_identyfikator nie istnieje
typehttps://developers.nest.com/reference/error-messages#where-id-invalid
messagegdzie_identyfikator nie istnieje
details$where_id

gdzie_identyfikator musi być ciągiem

Format where_id jest nieprawidłowy. Na przykład zamiast ciągu wysłano liczbę.

Parametry
Kod stanu HTTP: 400 Nieprawidłowe żądanie
errorgdzie_identyfikator musi być ciągiem
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messagegdzie_identyfikator musi być ciągiem

Inne kody błędów i komunikaty

Kody błędów urządzenia

W przypadku kodów błędów i komunikatów dotyczących urządzenia niezwiązanych z interfejsem Nest API zapoznaj się z tymi informacjami:

Kody błędów REST

Po wywołaniu interfejsu API REST są zwracane typowe kody stanu HTTP.

Komunikaty o ograniczeniach REST

Jeśli używasz REST i wysyłasz zbyt wiele wywołań w krótkim czasie, możesz otrzymać kod stanu odpowiedzi HTTP 429 Zbyt wiele żądań.

Więcej informacji znajdziesz w artykule Limity transmisji danych.