Le condizioni di errore fanno parte del ciclo di sviluppo e possono variare da semplici errori, ad esempio un parametro non valido o mancante, a scenari più complessi, ad esempio uno stato imprevisto o impostazioni relative ai dispositivi, che devono essere risolti al di fuori dell'API.
Quando si verifica un errore durante una chiamata API, viene inviata una risposta in questo formato:
{ "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" } }
Tutti i messaggi di errore contengono i campi error
, type
, message
e instance
. L'oggetto details
è facoltativo.
Campo | Description |
---|---|
error |
Formato del messaggio di errore breve. |
type
|
fornisce un URL che fornisce informazioni dettagliate sulla condizione di errore (questa pagina). |
message
|
Formato di messaggio di errore lungo che potrebbe utilizzare variabili per fornire dettagli aggiuntivi. Quando una variabile è inclusa nel messaggio,
verrà visualizzata nell'oggetto details . |
instance
|
Una stringa di testo contenente un identificatore di errore univoco per ogni singola chiamata. Potremmo chiederti il numero di istanza se segnali un problema con il servizio. |
details
|
Facoltativo. Contiene variabili inserite nella message . I messaggi possono contenere più variabili. |
Per informazioni sugli errori non correlati all'API Nest, consulta la pagina Altri codici di errore e messaggi.
Bloccata
È stato superato il limite di frequenza.
Parametri | |
---|---|
Codice di stato HTTP: 429 troppe richieste | |
error | Bloccata |
type | https://developers.nest.com/reference/error-messages#blocked |
message | Bloccata |
Impossibile attivare la ventola durante l'arresto di sicurezza per fumo/co
È attiva l'arresto di emergenza. Le chiamate API non sono accettate finché non viene ripristinato il normale funzionamento.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Impossibile attivare la ventola durante l'arresto di sicurezza per fumo/co |
type | https://developers.nest.com/reference/error-messages#safety-shutoff-on |
message | Impossibile attivare la ventola durante l'arresto di sicurezza per fumo/co |
Impossibile cambiare lo stato Fuori mentre il riscaldamento di emergenza è acceso
Il prodotto ha tentato di modificare lo stato Fuori mentre era attivo il riscaldamento di emergenza.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Impossibile cambiare lo stato Fuori mentre il riscaldamento di emergenza è acceso |
type | https://developers.nest.com/reference/error-messages#emergency-heat-is-on |
message | Impossibile cambiare lo stato Fuori mentre il riscaldamento di emergenza è acceso |
Impossibile cambiare la modalità di climatizzazione durante gli eventi di risparmio energetico
È in vigore un evento di risparmio energetico definito da un partner per l'energia Nest. Le chiamate API vengono rifiutate fino al termine dell'evento di risparmio energetico.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Impossibile cambiare la modalità di climatizzazione durante gli eventi di risparmio energetico |
type | https://developers.nest.com/reference/error-messages#energy-saving-event-on |
message | Impossibile cambiare la modalità di climatizzazione durante gli eventi di risparmio energetico |
Impossibile cambiare la modalità di climatizzazione
La modalità non è compatibile con la richiesta.
Ad esempio, potresti ricevere questo messaggio se:
- L'impianto di climatizzazione del termostato non supporta la modalità richiesta dal tuo prodotto:
heat
,cool
,heat-cool
oeco
. - La modalità HVAC è impostata su
eco
e il prodotto tenta di impostaretarget_temperature
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Impossibile cambiare la modalità HVAC a $mode ; la climatizzazione non può essere $action |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | Impossibile cambiare la modalità HVAC a $mode ; la climatizzazione non può essere $action |
details | $mode |
Impossibile cambiare la modalità HVAC quando è attivo il blocco del termostato
L'utente deve sbloccare il termostato prima che un prodotto possa scrivere dati.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Impossibile cambiare la modalità HVAC quando è attivo il blocco del termostato |
type | https://developers.nest.com/reference/error-messages#lock-enabled |
message | Impossibile cambiare la modalità HVAC quando è attivo il blocco del termostato |
Impossibile impostare simultaneamente le temperature C e F
Il prodotto ha cercato di impostare contemporaneamente le temperature target Celsius e Fahrenheit. Un prodotto deve impostare solo la temperatura ottimale specificata dal valore
temperature_scale
(C/F).
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Impossibile impostare simultaneamente le temperature C e F |
type | https://developers.nest.com/reference/error-messages#multiple-value-changes |
message | Impossibile impostare simultaneamente le temperature C e F |
Impossibile impostare fan_timer_active on/off a causa della modalità incompatibile
La ventola dell'impianto di climatizzazione è già accesa (manualmente dall'utente, in base a una programmazione o a causa di un ciclo di riscaldamento/freddo di climatizzazione).
Se non ottieni il risultato previsto, molto probabilmente è perché il dispositivo ha un comportamento integrato che non possiamo sostituire tramite l'API.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Impossibile impostare fan_timer_active on/off a causa della modalità incompatibile $mode |
type | https://developers.nest.com/reference/error-messages#incompatible-fan-mode |
message | Impossibile impostare fan_timer_active on/off a causa della modalità incompatibile $mode |
details | $mode |
Impossibile impostare fan_timer_duration sul valore selezionato
Il prodotto ha cercato di impostare fan_timer_duration
su un valore non valido. Consulta
fan_timer_duration
per un elenco dei valori validi.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Impossibile impostare fan_timer_duration sul valore selezionato. Consulta i riferimenti API per i valori consentiti. |
type | https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration |
message | Impossibile impostare fan_timer_duration sul valore selezionato. Consulta i riferimenti API per i valori consentiti. |
Impossibile impostare una temperatura minima ottimale più alta della temperatura ottimale target
Il termostato è in modalità heat-cool
e il prodotto ha tentato di impostare una temperatura ottimale/bassa che non rientra nell'intervallo. Ad esempio, il prodotto
ha provato a impostare target_temperature_low_c
su 25 °C quando
target_temperature_high_c
è pari a 24 °C.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Impossibile impostare una temperatura minima target di $lowTemp superiore alla temperatura massima target $highTemp |
type | https://developers.nest.com/reference/error-messages#low-high-error |
message | Impossibile impostare una temperatura minima target di $lowTemp superiore alla temperatura massima target $highTemp |
details | $lowTemp |
Impossibile impostare una temperatura ottimale più vicina di N gradi C/F
Il prodotto ha tentato di impostare un valore di temperatura ottimale troppo vicino alla temperatura ottimale/bassa (ad esempio, target_temperature_high_f
).
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Impossibile impostare una temperatura ottimale più vicina di N gradi C/F |
type | https://developers.nest.com/reference/error-messages#range-error |
message | Impossibile impostare una temperatura ottimale più vicina di $min gradi $scale |
details | $min $scale |
Impossibile impostare il valore di target_temperature quando la modalità è $mode
Il termostato o la struttura sono attualmente in una modalità che non supporta le richieste API.
Ad esempio, non puoi impostare target_temperature_f
o target_temperature_c
quando l'impianto di climatizzazione è off
o in modalità heat-cool
. Il valore non può essere modificato finché il termostato/struttura non torna a una modalità senza restrizioni.
In questo messaggio,$fieldName
può essere uno qualsiasi dei valori della temperatura ottimale e
$mode
può essere uno dei seguenti: eco
, emer_heat_enable
, heat-cool
, heat
, cool
,
off
, hvac_safety_shutoff_active
.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Impossibile impostare il valore di target_temperature quando la modalità è $mode |
type | https://developers.nest.com/reference/error-messages#mode-error |
message | Impossibile impostare $fieldName mentre la modalità è $mode |
details | $fieldName |
Per poter cambiare la modalità HVAC è necessario l'aggiornamento del firmware del dispositivo
Per impostare le temperature Eco, il dispositivo deve essere aggiornato alla versione firmware corrente.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Per poter cambiare la modalità HVAC è necessario l'aggiornamento del firmware del dispositivo. Gli aggiornamenti sono automatici, in genere entro una settimana dal rilascio. |
type | https://developers.nest.com/reference/error-messages#unsupported-firmware-version |
message | Per poter cambiare la modalità HVAC è necessario l'aggiornamento del firmware del dispositivo. Gli aggiornamenti sono automatici, in genere entro una settimana dal rilascio. |
Errore durante la convalida dei campi WWN
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Errore durante la convalida dei campi WWN: $error |
type | https://developers.nest.com/reference/error-messages#where-id-internal |
message | Errore durante la convalida dei campi WWN: $error |
details | $error |
L'orario di arrivo stimato è nel passato
L'orario di arrivo stimato specificato è nel passato (prima di NOW). Per ulteriori informazioni sull'esecuzione di chiamate relative all'orario di arrivo stimato, consulta la Guida di Fuori casa e AMP.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | L'orario di arrivo stimato è nel passato: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
type | https://developers.nest.com/reference/error-messages#eta-in-the-past |
message | L'orario di arrivo stimato è nel passato: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
details | $estimatedArrivalTime |
L'orario di arrivo stimato è troppo futuro
L'orario di arrivo stimato specificato non può essere superiore a otto ore. Per ulteriori informazioni su come effettuare chiamate dall'orario di arrivo stimato, consulta la Guida di Fuori casa e AMP.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | L'orario di arrivo stimato è troppo futuro |
type | https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future |
message | L'orario di arrivo stimato è troppo futuro |
fan_timer_active non impostato
Il campo fan_timer_active
non è definito.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | fan_timer_active non impostato |
type | https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing |
message | fan_timer_active non impostato |
Non consentito
Le credenziali utilizzate per accedere al servizio Nest non sono valide.
Parametri | |
---|---|
Codice di stato HTTP: 403 vietato | |
error | Non consentito |
type | https://developers.nest.com/reference/error-messages#forbidden |
message | Non consentito |
Errore interno
Parametri | |
---|---|
Codice di stato HTTP: errore interno del server 500 | |
error | Errore interno |
type | https://developers.nest.com/reference/error-messages#internal-error |
message | Errore interno |
ID fotocamera non valido
Il campo camera-id
non è valido.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | ID fotocamera $id non valido |
type | https://developers.nest.com/reference/error-messages#invalid-camera-id |
message | ID fotocamera non valido: $id |
details | $id |
Contenuti non validi inviati
La chiamata include contenuti non validi. Ad esempio, utilizzando "yes" invece di "true" per una variabile booleana.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Contenuti non validi inviati |
type | https://developers.nest.com/reference/error-messages#invalid-content-sent |
message | Contenuti non validi inviati |
Percorso del frammento non valido
Parte del percorso della richiesta non è valida. Ad esempio, il nome di un oggetto o di un campo potrebbe contenere errori di ortografia.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Percorso del frammento non valido: $requestPath |
type | https://developers.nest.com/reference/error-messages#invalid-fragment |
message | Percorso del frammento non valido: $requestPath |
details | $requestPath |
Modalità HVAC non valida
L'impianto di climatizzazione del termostato non supporta la modalità richiesta dal prodotto:
heat
, cool
o heat-cool
.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Modalità HVAC non valida: $mode |
type | https://developers.nest.com/reference/error-messages#invalid-mode |
message | Modalità HVAC non valida: $mode |
details | $mode |
ID rilevatore di fumo+co non valido
Il campo smoke_co_alarm_id
non è valido.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | ID rilevatore di fumo+co $id non valido |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | ID rilevatore di fumo+co non valido: $id |
details | $id |
ID struttura non valido
Il campo structure_id
non è valido.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | ID struttura $id non valido |
type | https://developers.nest.com/reference/error-messages#invalid-structure-id |
message | ID struttura non valido: $id |
details | $id |
ID termostato non valido
Il campo thermostat_id
non è valido.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | ID termostato $id non valido |
type | https://developers.nest.com/reference/error-messages#invalid-thermostat-id |
message | ID termostato non valido: $id |
details | $id |
Valore non valido per Fuori
Hai tentato di impostare un valore non valido per away
.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Valore non valido per Fuori |
type | https://developers.nest.com/reference/error-messages#invalid-away-value |
message | Valore non valido: $value . Solo 'casa' e 'fuori'sono valori consentiti. |
details | $value |
is_streaming non è un valore booleano
Il prodotto ha tentato di impostare il campo is-streaming
su un valore non booleano.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | is_streaming non è un valore booleano |
type | https://developers.nest.com/reference/error-messages#invalid-is-stream-format |
message | is_streaming non è un valore booleano |
L'etichetta deve contenere meno di 256 caratteri
Il prodotto ha tentato di creare un'etichetta del termostato con più di 256 caratteri.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | L'etichetta deve contenere meno di $max_label_length caratteri |
type | https://developers.nest.com/reference/error-messages#max-label-length |
message | L'etichetta deve contenere meno di $max_label_length caratteri |
details | $max_label_length |
Numero massimo personalizzato in cui è stato superato il conteggio
Il prodotto ha tentato di creare un oggetto wheres
personalizzato superiore al massimo. Il numero massimo consentito di oggetti wheres
personalizzati è 32.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Numero massimo personalizzato in cui è stato superato il numero di $max_where_count |
type | https://developers.nest.com/reference/error-messages#max-where-count |
message | Numero massimo personalizzato in cui è stato superato il numero di $max_where_count |
details | $max_where_count |
Valore massimo personalizzato per cui è stata superata la lunghezza del nome
Il campo name
è troppo lungo. Consigliamo meno di 30 caratteri.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Valore personalizzato massimo per cui è stata superata la lunghezza del nome $max_custom_where_name_length |
type | https://developers.nest.com/reference/error-messages#max-where-name-length |
message | Valore personalizzato massimo per cui è stata superata la lunghezza del nome $max_custom_where_name_length |
details | $max_custom_where_name_length |
Campo mancante
Nella chiamata manca un parametro obbligatorio.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Campo mancante: $fieldName |
type | https://developers.nest.com/reference/error-messages#field-is-missing |
message | Campo mancante: $fieldName |
details | $fieldName |
ID posizione mancante
Formato where_id
mancante.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | ID posizione mancante |
type | https://developers.nest.com/reference/error-messages#where-id-missing |
message | ID posizione mancante |
Nessuna ventola di climatizzazione
L'impianto di climatizzazione non ha una ventola indipendente.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Nessun ventilatore hvac |
type | https://developers.nest.com/reference/error-messages#no-hvac-fan |
message | Nessun ventilatore hvac |
Nessun termostato online
Il termostato è attualmente offline. Dopo aver attivato il Wi-Fi, il prodotto dovrebbe riottenere l'accesso.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Nessun termostato online |
type | https://developers.nest.com/reference/error-messages#no-thermostats-online |
message | Nessun termostato online |
Nessun dispositivo accoppiato
I dispositivi Nest dell'utente non sono associati all'Account Nest dell'utente.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Nessun dispositivo accoppiato |
type | https://developers.nest.com/reference/error-messages#no-paired-devices |
message | Nessun dispositivo accoppiato |
Nessun orario di arrivo stimato valido per l'annullamento
La corsa non è valida e non può essere annullata.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Nessun orario di arrivo stimato valido per l'annullamento |
type | https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel |
message | Nessun orario di arrivo stimato valido per l'annullamento |
Nessuna autorizzazione di scrittura per i campi
Il client non dispone dell'autorizzazione di scrittura per questi dati. Per ulteriori informazioni, consulta la panoramica sulle autorizzazioni.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Nessuna autorizzazione di scrittura per i campi: $fields |
type | https://developers.nest.com/reference/error-messages#no-write-permission |
message | Nessuna autorizzazione di scrittura per i campi: $fields |
details | $fields |
Tipo di richiesta non valido
Il tipo di richiesta non è valido. Ad esempio, è stata effettuata una chiamata POST quando è richiesto un PUT.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Tipo di richiesta non valido: $requestType |
type | https://developers.nest.com/reference/error-messages#request-type-not-allowed |
message | Tipo di richiesta non valido: $requestType |
details | $requestType |
Non trovato
La chiamata ha tentato di leggere un percorso che non esiste.
Parametri | |
---|---|
Codice di stato HTTP: 404 non trovato | |
error | Non trovato |
type | https://developers.nest.com/reference/error-messages#not-found |
message | Non trovato |
Non in modalità Fuori
La struttura non è in modalità Fuori quando viene effettuata una chiamata Orario di arrivo stimato. Le chiamate ETA sono accettate solo quando la struttura è impostata su Fuori.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Non in modalità Fuori |
type | https://developers.nest.com/reference/error-messages#not-in-away-mode |
message | Non in modalità Fuori |
Non scrivibile
Il campo in cui stai tentando di scrivere è di sola lettura.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Non scrivibile |
type | https://developers.nest.com/reference/error-messages#not-writable |
message | Non scrivibile |
Solo dove deve essere fornito il nome
Nella chiamata wheres
erano inclusi altri campi.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Solo dove deve essere fornito il nome |
type | https://developers.nest.com/reference/error-messages#extra-fields |
message | Solo dove deve essere fornito il nome |
POST non è un tipo di richiesta valido
Il tipo di richiesta non è valido. Ad esempio, è stata effettuata una chiamata POST quando è richiesto un PUT.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | POST non è un tipo di richiesta valido |
type | https://developers.nest.com/reference/error-messages#invalid-request-type |
message | POST non è un tipo di richiesta valido |
Violazione dello schema
Si è verificato un errore durante l'accoppiamento dei dispositivi.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Violazione dello schema |
type | https://developers.nest.com/reference/error-messages#schema-violation-error |
message | Violazione dello schema |
Servizio non disponibile
Parametri | |
---|---|
Codice di stato HTTP: 503 servizio non disponibile | |
error | Servizio non disponibile |
type | https://developers.nest.com/reference/error-messages#service-unavailable |
message | Servizio non disponibile |
La struttura ha già raggiunto il numero massimo di dispositivi accoppiati consentito
Nella struttura è già presente il numero massimo di dispositivi consentiti.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | La struttura ha già raggiunto il numero massimo di dispositivi accoppiati consentito |
type | https://developers.nest.com/reference/error-messages#max-number-devices-error |
message | La struttura ha già raggiunto il numero massimo di dispositivi accoppiati consentito |
La proprietà non è di proprietà dell'utente
structure_id
non corrisponde all'account utente del record.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | La proprietà non è di proprietà dell'utente. |
type | https://developers.nest.com/reference/error-messages#structure-ownership-error-uri |
message | La proprietà non è di proprietà dell'utente. |
La temperatura C è troppo alta per la temperatura di blocco
Il termostato è stato bloccato dall'utente e il prodotto ha tentato di impostare una temperatura ottimale di Celsius superiore all'intervallo di temperatura di blocco.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | La temperatura C $tempC è troppo alta per la temperatura di blocco $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-c-value-4-lock |
message | La temperatura C $tempC è troppo alta per la temperatura di blocco $highLockTemp |
details | $tempC |
La temperatura C è troppo bassa per la temperatura di blocco
Il termostato è stato bloccato dall'utente e il prodotto ha tentato di impostare una temperatura ottimale di Celsius inferiore all'intervallo di temperatura di blocco.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | La temperatura C $tempC è troppo bassa per la temperatura di blocco $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-c-value-4-lock |
message | La temperatura C $tempC è troppo bassa per la temperatura di blocco $lowLockTemp |
details | $tempC |
La temperatura C è troppo alta
Il prodotto ha tentato di impostare un valore di temperatura ottimale troppo alto per una temperatura di Cesius. Per conoscere gli intervalli di temperature consentiti in gradi Celsius, consulta
target_temperature_c
.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | La temperatura C è troppo alta: $tempC |
type | https://developers.nest.com/reference/error-messages#high-c-value |
message | La temperatura C è troppo alta: $tempC |
details | $tempC |
Il valore della temperatura C è troppo basso
Il prodotto ha tentato di impostare un valore di temperatura ottimale troppo basso per una temperatura di Cesius. Per conoscere gli intervalli di temperature consentiti in gradi Celsius, consulta
target_temperature_c
.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Il valore della temperatura C è troppo basso: $tempC |
type | https://developers.nest.com/reference/error-messages#low-c-value |
message | Il valore della temperatura C è troppo basso: $tempC |
details | $tempC |
La temperatura F è troppo alta per la temperatura di blocco
Il termostato è stato bloccato dall'utente e il prodotto ha tentato di impostare una temperatura ottimale di Fahrenheit superiore all'intervallo di temperatura di blocco.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | La temperatura F $tempF è troppo alta per la temperatura di blocco $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-f-value-4-lock |
message | La temperatura F $tempF è troppo alta per la temperatura di blocco $highLockTemp |
details | $tempF |
La temperatura F è troppo bassa per la temperatura di blocco
Il termostato è stato bloccato dall'utente e il prodotto ha tentato di impostare una temperatura ottimale di Fahrenheit inferiore all'intervallo di temperatura bloccato.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | La temperatura F $tempF è troppo bassa per la temperatura di blocco $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-f-value-4-lock |
message | La temperatura F $tempF è troppo bassa per la temperatura di blocco $lowLockTemp |
details | $tempF |
Il valore della temperatura F è troppo alto
Il prodotto ha tentato di impostare un valore di temperatura ottimale troppo alto per una temperatura Fahrenheit. Per gli intervalli di temperatura consentiti in Fahrenheit, consulta
target_temperature_f
.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Il valore della temperatura F è troppo alto: $tempF |
type | https://developers.nest.com/reference/error-messages#high-f-value |
message | Il valore della temperatura F è troppo alto: $tempF |
details | $tempF |
Il valore della temperatura F è troppo basso
Il prodotto ha tentato di impostare un valore di temperatura ottimale troppo basso per una temperatura Fahrenheit. Per gli intervalli di temperatura consentiti in Fahrenheit, consulta
target_temperature_f
.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Il valore della temperatura F è troppo basso: $tempF |
type | https://developers.nest.com/reference/error-messages#low-f-value |
message | Il valore della temperatura F è troppo basso: $tempF |
details | $tempF |
Il formato della temperatura è sbagliato
Il prodotto ha tentato di impostare una temperatura ottimale utilizzando il formato numerico errato
per il campo temperature_scale
selezionato. Le temperature Celsius devono essere numeri interi con incrementi di 0,5 gradi (21,5) e le temperature Fahrenheit devono essere numeri interi (72).
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Il formato della temperatura $temp è sbagliato |
type | https://developers.nest.com/reference/error-messages#format-error |
message | Il formato della temperatura $temp è sbagliato |
details | $temp |
I campi non possono essere modificati all'aggiornamento
Il prodotto ha tentato di scrivere in un campo di sola lettura.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Impossibile modificare i campi all'aggiornamento: $fieldNames |
type | https://developers.nest.com/reference/error-messages#read-only-field-error |
message | Impossibile modificare i campi all'aggiornamento: $fieldNames |
details | $fieldNames |
I campi devono utilizzare il formato ISO 8601
Il campo non è in formato ISO 8601.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Il campo o i campi devono utilizzare il formato ISO 8601: $fieldNames |
type | https://developers.nest.com/reference/error-messages#time-format-error |
message | Il campo o i campi devono utilizzare il formato ISO 8601: $fieldNames |
details | $fieldNames |
Il termostato non è online
Il termostato è attualmente offline. Dopo aver attivato il Wi-Fi, il prodotto dovrebbe riottenere l'accesso.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Il termostato non è online |
type | https://developers.nest.com/reference/error-messages#not-online |
message | Il termostato non è online |
Questa corsa è stata sostituita manualmente
L'utente ha sostituito manualmente la corsa.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Questa corsa è stata sostituita manualmente |
type | https://developers.nest.com/reference/error-messages#trip-manually-overidden |
message | Questa corsa è stata sostituita manualmente |
Impossibile creare l'ID
Oggetto wheres
mancante. Non sono definiti valori where_id
.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Impossibile creare l'ID posizione |
type | https://developers.nest.com/reference/error-messages#wheres-missing |
message | Impossibile creare l'ID posizione |
Non autorizzato
Autorizzazione non riuscita.
Questo messaggio di errore potrebbe essere generato da un paio di condizioni:
reindirizzamenti errati che si verificano quando una determinata implementazione HTTP non inoltra automaticamente l'intestazione Authorization all'URI reindirizzato. Per ulteriori informazioni, consulta la sezione Gestire i reindirizzamenti.
autorizzazioni errate quando si prova ad accedere agli endpoint API. Ad esempio, provare a leggere un endpoint del termostato quando sono selezionate solo le autorizzazioni della fotocamera per il client. Per saperne di più, vedi Come scegliere le autorizzazioni.
Parametri | |
---|---|
Codice di stato HTTP: 401 non autorizzato | |
error | Non autorizzato |
type | https://developers.nest.com/reference/error-messages#auth-error |
message | Non autorizzato |
Sconosciuto
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | sconosciuto |
type | https://developers.nest.com/reference/error-messages#unknown |
message | sconosciuto |
Tipo di dispositivo/fornitore sconosciuto
Fornitore/dispositivo non riconosciuto durante l'accoppiamento del dispositivo.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Tipo di dispositivo/fornitore sconosciuto |
type | https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error |
message | Tipo di dispositivo/fornitore sconosciuto |
Il valore di $fieldName è di tipo errato
È stato inviato il tipo di dati errato. Ad esempio, inviare una stringa quando è previsto un valore booleano.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Il valore di $fieldName è di tipo errato |
type | https://developers.nest.com/reference/error-messages#wrong-data-type |
message | Il valore di $fieldName è di tipo errato |
details | $fieldName |
Dove esiste già il nome
Il where_name
che il prodotto ha tentato di impostare è già esistente. Riprova con un nuovo nome.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Dove esiste già il nome $name |
type | https://developers.nest.com/reference/error-messages#where-name-exists |
message | Dove esiste già il nome $name |
details | $name |
Dove non viene fornito il nome
where_name
non presente nella chiamata.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Dove non viene fornito il nome |
type | https://developers.nest.com/reference/error-messages#where-name-missing |
message | Dove non viene fornito il nome |
Dove il nome non ha lunghezza
Il campo name
non è definito (non contiene caratteri).
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Dove il nome non ha lunghezza |
type | https://developers.nest.com/reference/error-messages#zero-length-where-name |
message | Dove il nome non ha lunghezza |
Dove il nome deve essere una stringa
È stato inviato il tipo di dati errato per where_name
. Ad esempio, un numero quando è prevista una stringa.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | Dove il nome deve essere una stringa |
type | https://developers.nest.com/reference/error-messages#where-name-wrong-format |
message | Dove il nome deve essere una stringa |
dove_id non esiste
Il campo where_id
non è valido.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | dove_id non esiste |
type | https://developers.nest.com/reference/error-messages#where-id-invalid |
message | dove_id non esiste |
details | $where_id |
dove_id deve essere una stringa
Il formato where_id
non è valido. Ad esempio, è stato inviato un numero anziché una stringa.
Parametri | |
---|---|
Codice di stato HTTP: richiesta 400 non valida | |
error | dove_id deve essere una stringa |
type | https://developers.nest.com/reference/error-messages#where-id-wrong-format |
message | dove_id deve essere una stringa |
Altri codici di errore e messaggi
Codici di errore del dispositivo
Per codici di errore specifici del dispositivo e messaggi non correlati all'API Nest, consulta quanto segue:
Codici di errore REST
Quando effettui una chiamata API REST, vengono restituiti codici di stato HTTP comuni.
Messaggi relativi alla limitazione di frequenza REST
Quando utilizzi REST e invii troppe chiamate in un breve periodo di tempo, potresti ricevere un codice di stato risposta HTTP 429 Too Many Request.
Per saperne di più, consulta la sezione Limiti di frequenza dati.