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-coollubeco - Tryb HVAC jest ustawiony na
ecoi 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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 .