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ń | |
error | Zablokowano |
type | https://developers.nest.com/reference/error-messages#blocked |
message | Zablokowano |
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 | |
error | Nie można włączyć wentylatora w momencie wyłączenia dymu/bezpieczeństwa |
type | https://developers.nest.com/reference/error-messages#safety-shutoff-on |
message | Nie 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 | |
error | Nie można zmienić stanu Poza domem, gdy ogrzewanie awaryjne jest włączone |
type | https://developers.nest.com/reference/error-messages#emergency-heat-is-on |
message | Nie 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 | |
error | Nie można zmienić trybu ogrzewania/wentylacji/klimatyzacji podczas oszczędzania energii |
type | https://developers.nest.com/reference/error-messages#energy-saving-event-on |
message | Nie 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
lubeco
- 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 | |
error | Nie można zmienić trybu ogrzewania/wentylacji/klimatyzacji na $mode ; HVAC nie może $action |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | Nie można zmienić trybu ogrzewania/wentylacji/klimatyzacji na $mode ; HVAC nie może $action |
details | $mode |
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 | |
error | Nie można zmienić trybu ogrzewania/wentylacji/klimatyzacji przy włączonej blokady termostatu |
type | https://developers.nest.com/reference/error-messages#lock-enabled |
message | Nie 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 | |
error | Nie można ustawić temperatury C i F jednocześnie |
type | https://developers.nest.com/reference/error-messages#multiple-value-changes |
message | Nie 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 | |
error | Nie można włączyć ani wyłączyć ustawienia 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ć 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 | |
error | Nie można ustawić wartości Fan_timer_duration na wybraną wartość. Dozwolone wartości znajdziesz w dokumentacji API. |
type | https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration |
message | Nie 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 | |
error | Nie można ustawić niskiej temperatury docelowej $lowTemp wyższej niż docelowa temperatura maksymalna $highTemp |
type | https://developers.nest.com/reference/error-messages#low-high-error |
message | Nie można ustawić niskiej temperatury docelowej $lowTemp wyższej niż docelowa temperatura maksymalna $highTemp |
details | $lowTemp |
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 | |
error | Nie można ustawić temperatury docelowej wyższej niż N stopni/C |
type | https://developers.nest.com/reference/error-messages#range-error |
message | Nie 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 | |
error | Nie można ustawić wartości docelowej_temperatura, gdy tryb jest $mode |
type | https://developers.nest.com/reference/error-messages#mode-error |
message | Nie można ustawić zasady $fieldName , gdy tryb jest $mode |
details | $fieldName |
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 | |
error | Przed zmianą trybu ogrzewania/wentylacji/klimatyzacji musisz zaktualizować oprogramowanie układowe urządzenia. Aktualizacje są automatyczne, zazwyczaj w ciągu tygodnia od wydania. |
type | https://developers.nest.com/reference/error-messages#unsupported-firmware-version |
message | Przed 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 | |
error | Podczas weryfikowania pól WWN wystąpił błąd: $error |
type | https://developers.nest.com/reference/error-messages#where-id-internal |
message | Podczas 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 | |
error | Szacowany czas dotarcia przypada w przeszłości: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
type | https://developers.nest.com/reference/error-messages#eta-in-the-past |
message | Szacowany czas dotarcia przypada w przeszłości: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
details | $estimatedArrivalTime |
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 | |
error | Szacowany czas dotarcia na przyszłość jest zbyt odległy |
type | https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future |
message | Szacowany 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 | |
error | Parametr fan_timer_active nie jest ustawiony |
type | https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing |
message | Parametr 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 | |
error | Zabroniono |
type | https://developers.nest.com/reference/error-messages#forbidden |
message | Zabroniono |
Błąd wewnętrzny
Parametry | |
---|---|
HTTP Status Code: 500 Internal Server Error (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 kamery
Element camera-id
jest nieprawidłowy.
Parametry | |
---|---|
Kod stanu HTTP: 400 Nieprawidłowe żądanie | |
error | Nieprawidłowy identyfikator kamery $id |
type | https://developers.nest.com/reference/error-messages#invalid-camera-id |
message | Nieprawidł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 | |
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 zostać błędnie wpisana.
Parametry | |
---|---|
Kod stanu HTTP: 400 Nieprawidłowe żą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 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 | |
error | Nieprawidłowy tryb ogrzewania/wentylacji/klimatyzacji: $mode |
type | https://developers.nest.com/reference/error-messages#invalid-mode |
message | Nieprawidł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 | |
error | Nieprawidłowy identyfikator alarmu z czujnika dymu + co $id |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | Nieprawidł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 | |
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
Element thermostat_id
jest nieprawidłowy.
Parametry | |
---|---|
Kod stanu HTTP: 400 Nieprawidłowe żą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ść Nieobecność
Próbujesz ustawić nieprawidłową wartość away
.
Parametry | |
---|---|
Kod stanu HTTP: 400 Nieprawidłowe żądanie | |
error | Nieprawidłowa wartość Nieobecność |
type | https://developers.nest.com/reference/error-messages#invalid-away-value |
message | Nieprawidłowa wartość: $value . Dozwolone są tylko wartości 'home' &&33;away'. |
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 | |
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ą ponad 256 znaków.
Parametry | |
---|---|
Kod stanu HTTP: 400 Nieprawidłowe żądanie | |
error | Etykieta musi mieć mniej znaków niż $max_label_length |
type | https://developers.nest.com/reference/error-messages#max-label-length |
message | Etykieta 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 | |
error | Maksymalne ustawienie niestandardowe, w którym przekroczono liczbę zdarzeń „$max_where_count ” |
type | https://developers.nest.com/reference/error-messages#max-where-count |
message | Maksymalne 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 | |
error | Maksymalna niestandardowa wartość, w której przekroczyła długość $max_custom_where_name_length |
type | https://developers.nest.com/reference/error-messages#max-where-name-length |
message | Maksymalna 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 | |
error | Brak pola: $fieldName |
type | https://developers.nest.com/reference/error-messages#field-is-missing |
message | Brak pola: $fieldName |
details | $fieldName |
Brak identyfikatora „Gdzie”
Brak formatu where_id
.
Parametry | |
---|---|
Kod stanu HTTP: 400 Nieprawidłowe żądanie | |
error | Brak identyfikatora „Gdzie” |
type | https://developers.nest.com/reference/error-messages#where-id-missing |
message | Brak 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 | |
error | Brak wentylatora ogrzewania/wentylacji/klimatyzacji |
type | https://developers.nest.com/reference/error-messages#no-hvac-fan |
message | Brak 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 | |
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 jego kontem Nest.
Parametry | |
---|---|
Kod stanu HTTP: 400 Nieprawidłowe żądanie | |
error | Brak sparowanych urządzeń |
type | https://developers.nest.com/reference/error-messages#no-paired-devices |
message | Brak 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 | |
error | Brak prawidłowego szacowanego czasu dotarcia do anulowania |
type | https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel |
message | Brak 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 | |
error | Brak uprawnień do zapisu w tych polach: $fields |
type | https://developers.nest.com/reference/error-messages#no-write-permission |
message | Brak 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 | |
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óbuje odczytać ścieżkę, która nie istnieje.
Parametry | |
---|---|
HTTP Status Code: 404 – nie znaleziono | |
error | Nie znaleziono |
type | https://developers.nest.com/reference/error-messages#not-found |
message | Nie 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 | |
error | Poza trybem Poza domem |
type | https://developers.nest.com/reference/error-messages#not-in-away-mode |
message | Poza 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 | |
error | Brak możliwości zapisu |
type | https://developers.nest.com/reference/error-messages#not-writable |
message | Brak 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 | |
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 wymagany jest plik PUT.
Parametry | |
---|---|
Kod stanu HTTP: 400 Nieprawidłowe żą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
Podczas parowania urządzeń wystąpił błąd.
Parametry | |
---|---|
Kod stanu HTTP: 400 Nieprawidłowe żądanie | |
error | Naruszenie schematu |
type | https://developers.nest.com/reference/error-messages#schema-violation-error |
message | Naruszenie schematu |
Usługa niedostępna
Parametry | |
---|---|
Kod stanu HTTP: Usługa 503 niedostępna | |
error | Usługa niedostępna |
type | https://developers.nest.com/reference/error-messages#service-unavailable |
message | Usł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 | |
error | W strukturze jest już maksymalna dozwolona liczba sparowanych urządzeń |
type | https://developers.nest.com/reference/error-messages#max-number-devices-error |
message | W 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 | |
error | Struktura nie należy do użytkownika. |
type | https://developers.nest.com/reference/error-messages#structure-ownership-error-uri |
message | Struktura 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 | |
error | Temperatura C $tempC jest za wysoka dla temperatury blokady $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-c-value-4-lock |
message | Temperatura C $tempC jest za wysoka dla temperatury blokady $highLockTemp |
details | $tempC |
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 | |
error | Temperatura C $tempC jest za niska dla temperatury blokady $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-c-value-4-lock |
message | Temperatura C $tempC jest za niska dla temperatury blokady $lowLockTemp |
details | $tempC |
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 | |
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 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 | |
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, 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 | |
error | Temperatura F $tempF jest za wysoka dla temperatury blokady $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-f-value-4-lock |
message | Temperatura F $tempF jest za wysoka dla temperatury blokady $highLockTemp |
details | $tempF |
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 | |
error | Temperatura F $tempF jest za niska, aby temperatura blokady $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-f-value-4-lock |
message | Temperatura F $tempF jest za niska, aby temperatura blokady $lowLockTemp |
details | $tempF |
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 | |
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ć 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 | |
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 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 | |
error | Temperatura $temp ma nieprawidłowy format |
type | https://developers.nest.com/reference/error-messages#format-error |
message | Temperatura $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 | |
error | Tych pól nie można zmieniać podczas aktualizacji: $fieldNames |
type | https://developers.nest.com/reference/error-messages#read-only-field-error |
message | Tych 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 | |
error | Pola powinny używać formatu ISO 8601: $fieldNames |
type | https://developers.nest.com/reference/error-messages#time-format-error |
message | Pola 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 | |
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 zastąpił podróż.
Parametry | |
---|---|
Kod stanu HTTP: 400 Nieprawidłowe żą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 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 | |
error | Nie można utworzyć, gdzie jest identyfikator |
type | https://developers.nest.com/reference/error-messages#wheres-missing |
message | Nie 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 | |
error | Brak autoryzacji |
type | https://developers.nest.com/reference/error-messages#auth-error |
message | Brak autoryzacji |
Nieznany
Parametry | |
---|---|
Kod stanu HTTP: 400 Nieprawidłowe żądanie | |
error | nieznany |
type | https://developers.nest.com/reference/error-messages#unknown |
message | nieznany |
Nieznany typ dostawcy/urządzenia
Dostawca/urządzenie nie zostało rozpoznane podczas parowania urządzenia.
Parametry | |
---|---|
Kod stanu HTTP: 400 Nieprawidłowe żądanie | |
error | Nieznany typ dostawcy/urządzenia |
type | https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error |
message | Nieznany 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 | |
error | Wartość $fieldName ma niewłaściwy typ |
type | https://developers.nest.com/reference/error-messages#wrong-data-type |
message | Wartość $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 | |
error | Miejsce o nazwie $name już istnieje |
type | https://developers.nest.com/reference/error-messages#where-name-exists |
message | Miejsce 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 | |
error | Gdzie nie podano nazwy |
type | https://developers.nest.com/reference/error-messages#where-name-missing |
message | Gdzie 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 | |
error | Gdzie nazwa ma wartość zero |
type | https://developers.nest.com/reference/error-messages#zero-length-where-name |
message | Gdzie 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 | |
error | Gdzie nazwa musi być ciągiem znaków |
type | https://developers.nest.com/reference/error-messages#where-name-wrong-format |
message | Gdzie 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 | |
error | gdzie_identyfikator nie istnieje |
type | https://developers.nest.com/reference/error-messages#where-id-invalid |
message | gdzie_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 | |
error | gdzie_identyfikator musi być ciągiem |
type | https://developers.nest.com/reference/error-messages#where-id-wrong-format |
message | gdzie_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.