Messaggi di errore

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
errorBloccata
typehttps://developers.nest.com/reference/error-messages#blocked
messageBloccata

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
errorImpossibile attivare la ventola durante l'arresto di sicurezza per fumo/co
typehttps://developers.nest.com/reference/error-messages#safety-shutoff-on
messageImpossibile 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
errorImpossibile cambiare lo stato Fuori mentre il riscaldamento di emergenza è acceso
typehttps://developers.nest.com/reference/error-messages#emergency-heat-is-on
messageImpossibile 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
errorImpossibile cambiare la modalità di climatizzazione durante gli eventi di risparmio energetico
typehttps://developers.nest.com/reference/error-messages#energy-saving-event-on
messageImpossibile 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 o eco.
  • La modalità HVAC è impostata su eco e il prodotto tenta di impostare target_temperature
Parametri
Codice di stato HTTP: richiesta 400 non valida
errorImpossibile cambiare la modalità HVAC a $mode; la climatizzazione non può essere $action
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
messageImpossibile cambiare la modalità HVAC a $mode; la climatizzazione non può essere $action
details$mode
$action

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
errorImpossibile cambiare la modalità HVAC quando è attivo il blocco del termostato
typehttps://developers.nest.com/reference/error-messages#lock-enabled
messageImpossibile 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
errorImpossibile impostare simultaneamente le temperature C e F
typehttps://developers.nest.com/reference/error-messages#multiple-value-changes
messageImpossibile 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
errorImpossibile impostare fan_timer_active on/off a causa della modalità incompatibile $mode
typehttps://developers.nest.com/reference/error-messages#incompatible-fan-mode
messageImpossibile 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
errorImpossibile impostare fan_timer_duration sul valore selezionato. Consulta i riferimenti API per i valori consentiti.
typehttps://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
messageImpossibile 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
errorImpossibile impostare una temperatura minima target di $lowTemp superiore alla temperatura massima target $highTemp
typehttps://developers.nest.com/reference/error-messages#low-high-error
messageImpossibile impostare una temperatura minima target di $lowTemp superiore alla temperatura massima target $highTemp
details$lowTemp
$highTemp

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
errorImpossibile impostare una temperatura ottimale più vicina di N gradi C/F
typehttps://developers.nest.com/reference/error-messages#range-error
messageImpossibile 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
errorImpossibile impostare il valore di target_temperature quando la modalità è $mode
typehttps://developers.nest.com/reference/error-messages#mode-error
messageImpossibile impostare $fieldName mentre la modalità è $mode
details$fieldName
$mode

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
errorPer poter cambiare la modalità HVAC è necessario l'aggiornamento del firmware del dispositivo. Gli aggiornamenti sono automatici, in genere entro una settimana dal rilascio.
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
messagePer 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
errorErrore durante la convalida dei campi WWN: $error
typehttps://developers.nest.com/reference/error-messages#where-id-internal
messageErrore 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
errorL'orario di arrivo stimato è nel passato: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
typehttps://developers.nest.com/reference/error-messages#eta-in-the-past
messageL'orario di arrivo stimato è nel passato: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details$estimatedArrivalTime
$currentTime

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
errorL'orario di arrivo stimato è troppo futuro
typehttps://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
messageL'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
errorfan_timer_active non impostato
typehttps://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
messagefan_timer_active non impostato

Non consentito

Le credenziali utilizzate per accedere al servizio Nest non sono valide.

Parametri
Codice di stato HTTP: 403 vietato
errorNon consentito
typehttps://developers.nest.com/reference/error-messages#forbidden
messageNon consentito

Errore interno

Parametri
Codice di stato HTTP: errore interno del server 500
errorErrore interno
typehttps://developers.nest.com/reference/error-messages#internal-error
messageErrore interno

ID fotocamera non valido

Il campo camera-id non è valido.

Parametri
Codice di stato HTTP: richiesta 400 non valida
errorID fotocamera $id non valido
typehttps://developers.nest.com/reference/error-messages#invalid-camera-id
messageID 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
errorContenuti non validi inviati
typehttps://developers.nest.com/reference/error-messages#invalid-content-sent
messageContenuti 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
errorPercorso del frammento non valido: $requestPath
typehttps://developers.nest.com/reference/error-messages#invalid-fragment
messagePercorso 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
errorModalità HVAC non valida: $mode
typehttps://developers.nest.com/reference/error-messages#invalid-mode
messageModalità 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
errorID rilevatore di fumo+co $id non valido
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
messageID 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
errorID struttura $id non valido
typehttps://developers.nest.com/reference/error-messages#invalid-structure-id
messageID 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
errorID termostato $id non valido
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
messageID 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
errorValore non valido per Fuori
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
messageValore 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
erroris_streaming non è un valore booleano
typehttps://developers.nest.com/reference/error-messages#invalid-is-stream-format
messageis_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
errorL'etichetta deve contenere meno di $max_label_length caratteri
typehttps://developers.nest.com/reference/error-messages#max-label-length
messageL'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
errorNumero massimo personalizzato in cui è stato superato il numero di $max_where_count
typehttps://developers.nest.com/reference/error-messages#max-where-count
messageNumero 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
errorValore personalizzato massimo per cui è stata superata la lunghezza del nome $max_custom_where_name_length
typehttps://developers.nest.com/reference/error-messages#max-where-name-length
messageValore 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
errorCampo mancante: $fieldName
typehttps://developers.nest.com/reference/error-messages#field-is-missing
messageCampo mancante: $fieldName
details$fieldName

ID posizione mancante

Formato where_id mancante.

Parametri
Codice di stato HTTP: richiesta 400 non valida
errorID posizione mancante
typehttps://developers.nest.com/reference/error-messages#where-id-missing
messageID posizione mancante

Nessuna ventola di climatizzazione

L'impianto di climatizzazione non ha una ventola indipendente.

Parametri
Codice di stato HTTP: richiesta 400 non valida
errorNessun ventilatore hvac
typehttps://developers.nest.com/reference/error-messages#no-hvac-fan
messageNessun 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
errorNessun termostato online
typehttps://developers.nest.com/reference/error-messages#no-thermostats-online
messageNessun 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
errorNessun dispositivo accoppiato
typehttps://developers.nest.com/reference/error-messages#no-paired-devices
messageNessun 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
errorNessun orario di arrivo stimato valido per l'annullamento
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageNessun 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
errorNessuna autorizzazione di scrittura per i campi: $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
messageNessuna 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
errorTipo di richiesta non valido: $requestType
typehttps://developers.nest.com/reference/error-messages#request-type-not-allowed
messageTipo 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
errorNon trovato
typehttps://developers.nest.com/reference/error-messages#not-found
messageNon 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
errorNon in modalità Fuori
typehttps://developers.nest.com/reference/error-messages#not-in-away-mode
messageNon 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
errorNon scrivibile
typehttps://developers.nest.com/reference/error-messages#not-writable
messageNon scrivibile

Solo dove deve essere fornito il nome

Nella chiamata wheres erano inclusi altri campi.

Parametri
Codice di stato HTTP: richiesta 400 non valida
errorSolo dove deve essere fornito il nome
typehttps://developers.nest.com/reference/error-messages#extra-fields
messageSolo 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
errorPOST non è un tipo di richiesta valido
typehttps://developers.nest.com/reference/error-messages#invalid-request-type
messagePOST 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
errorViolazione dello schema
typehttps://developers.nest.com/reference/error-messages#schema-violation-error
messageViolazione dello schema

Servizio non disponibile

Parametri
Codice di stato HTTP: 503 servizio non disponibile
errorServizio non disponibile
typehttps://developers.nest.com/reference/error-messages#service-unavailable
messageServizio 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
errorLa struttura ha già raggiunto il numero massimo di dispositivi accoppiati consentito
typehttps://developers.nest.com/reference/error-messages#max-number-devices-error
messageLa 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
errorLa proprietà non è di proprietà dell'utente.
typehttps://developers.nest.com/reference/error-messages#structure-ownership-error-uri
messageLa 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
errorLa temperatura C $tempC è troppo alta per la temperatura di blocco $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-c-value-4-lock
messageLa temperatura C $tempC è troppo alta per la temperatura di blocco $highLockTemp
details$tempC
$highLockTemp

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
errorLa temperatura C $tempC è troppo bassa per la temperatura di blocco $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-c-value-4-lock
messageLa temperatura C $tempC è troppo bassa per la temperatura di blocco $lowLockTemp
details$tempC
$lowLockTemp

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
errorLa temperatura C è troppo alta: $tempC
typehttps://developers.nest.com/reference/error-messages#high-c-value
messageLa 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
errorIl valore della temperatura C è troppo basso: $tempC
typehttps://developers.nest.com/reference/error-messages#low-c-value
messageIl 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
errorLa temperatura F $tempF è troppo alta per la temperatura di blocco $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-f-value-4-lock
messageLa temperatura F $tempF è troppo alta per la temperatura di blocco $highLockTemp
details$tempF
$highLockTemp

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
errorLa temperatura F $tempF è troppo bassa per la temperatura di blocco $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-f-value-4-lock
messageLa temperatura F $tempF è troppo bassa per la temperatura di blocco $lowLockTemp
details$tempF
$lowLockTemp

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
errorIl valore della temperatura F è troppo alto: $tempF
typehttps://developers.nest.com/reference/error-messages#high-f-value
messageIl 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
errorIl valore della temperatura F è troppo basso: $tempF
typehttps://developers.nest.com/reference/error-messages#low-f-value
messageIl 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
errorIl formato della temperatura $temp è sbagliato
typehttps://developers.nest.com/reference/error-messages#format-error
messageIl 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
errorImpossibile modificare i campi all'aggiornamento: $fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
messageImpossibile 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
errorIl campo o i campi devono utilizzare il formato ISO 8601: $fieldNames
typehttps://developers.nest.com/reference/error-messages#time-format-error
messageIl 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
errorIl termostato non è online
typehttps://developers.nest.com/reference/error-messages#not-online
messageIl termostato non è online

Questa corsa è stata sostituita manualmente

L'utente ha sostituito manualmente la corsa.

Parametri
Codice di stato HTTP: richiesta 400 non valida
errorQuesta corsa è stata sostituita manualmente
typehttps://developers.nest.com/reference/error-messages#trip-manually-overidden
messageQuesta 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
errorImpossibile creare l'ID posizione
typehttps://developers.nest.com/reference/error-messages#wheres-missing
messageImpossibile 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
errorNon autorizzato
typehttps://developers.nest.com/reference/error-messages#auth-error
messageNon autorizzato

Sconosciuto

Parametri
Codice di stato HTTP: richiesta 400 non valida
errorsconosciuto
typehttps://developers.nest.com/reference/error-messages#unknown
messagesconosciuto

Tipo di dispositivo/fornitore sconosciuto

Fornitore/dispositivo non riconosciuto durante l'accoppiamento del dispositivo.

Parametri
Codice di stato HTTP: richiesta 400 non valida
errorTipo di dispositivo/fornitore sconosciuto
typehttps://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
messageTipo 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
errorIl valore di $fieldName è di tipo errato
typehttps://developers.nest.com/reference/error-messages#wrong-data-type
messageIl 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
errorDove esiste già il nome $name
typehttps://developers.nest.com/reference/error-messages#where-name-exists
messageDove 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
errorDove non viene fornito il nome
typehttps://developers.nest.com/reference/error-messages#where-name-missing
messageDove 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
errorDove il nome non ha lunghezza
typehttps://developers.nest.com/reference/error-messages#zero-length-where-name
messageDove 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
errorDove il nome deve essere una stringa
typehttps://developers.nest.com/reference/error-messages#where-name-wrong-format
messageDove 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
errordove_id non esiste
typehttps://developers.nest.com/reference/error-messages#where-id-invalid
messagedove_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
errordove_id deve essere una stringa
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messagedove_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.