Le condizioni di errore fanno parte del ciclo di sviluppo e possono variare da semplici errori, come un parametro non valido o mancante, a scenari più complessi, come uno stato imprevisto o persino impostazioni relative al dispositivo, 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 di error , type , message e instance . L'oggetto details è facoltativo.
| Campo | Descrizione |
|---|---|
error | Breve formato del messaggio di errore. |
type | Fornisce un URL per informazioni dettagliate sulla condizione di errore (questa pagina). |
message | Formato di messaggio di errore lungo che può utilizzare le variabili per fornire ulteriori dettagli. Quando una variabile è inclusa nel messaggio, apparirà nell'oggetto details . |
instance | Una stringa di testo che contiene un identificatore di errore univoco per ogni singola chiamata. Potremmo chiederti il numero di istanza se segnali un problema con il servizio. |
details | Opzionale. Contiene variabili che vengono inserite nel message . I messaggi possono contenere più variabili. |
Per informazioni sugli errori non correlati all'API Nest, vedere Altri codici e messaggi di errore .
bloccato
Il limite di velocità è stato superato.
| parametri | |
|---|---|
| Codice di stato HTTP: 429 Troppe richieste | |
error | bloccato |
type | https://developers.nest.com/reference/error-messages#blocked |
message | bloccato |
Impossibile attivare la ventola durante l'arresto di sicurezza fumo / co
L'arresto di emergenza è attivo . Le chiamate API non vengono accettate fino al ripristino del normale funzionamento.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Impossibile attivare la ventola durante l'arresto di sicurezza fumo / co |
type | https://developers.nest.com/reference/error-messages#safety-shutoff-on |
message | Impossibile attivare la ventola durante l'arresto di sicurezza fumo / co |
Impossibile cambiare lo stato di assenza mentre il riscaldamento di emergenza è acceso
Il prodotto ha tentato di cambiare lo stato di assenza mentre il riscaldamento di emergenza era acceso.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Impossibile cambiare lo stato di assenza mentre il riscaldamento di emergenza è acceso |
type | https://developers.nest.com/reference/error-messages#emergency-heat-is-on |
message | Impossibile cambiare lo stato di assenza mentre il riscaldamento di emergenza è acceso |
Impossibile modificare la modalità HVAC durante eventi a risparmio energetico
È attivo un evento di risparmio energetico definito da un partner energetico Nest. Le chiamate API vengono rifiutate fino alla fine dell'evento di risparmio energetico.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Impossibile modificare la modalità HVAC durante eventi a risparmio energetico |
type | https://developers.nest.com/reference/error-messages#energy-saving-event-on |
message | Impossibile modificare la modalità HVAC durante eventi a risparmio energetico |
Impossibile modificare la modalità HVAC
La modalità non è compatibile con la richiesta.
Ad esempio, potresti ricevere questo messaggio se:
- Il sistema HVAC del termostato non supporta la modalità richiesta dal prodotto:
heat,cool,heat-cooloeco - La modalità HVAC è impostata su
ecoe il prodotto tenta di impostaretarget_temperature
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Impossibile cambiare la modalità HVAC in $mode ; HVAC non può $action |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | Impossibile cambiare la modalità HVAC in $mode ; HVAC non può $action |
details | $mode |
Impossibile modificare la modalità HVAC mentre il blocco termostato è abilitato
L'utente deve sbloccare il termostato prima che un prodotto possa scrivere dati.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Impossibile modificare la modalità HVAC mentre il blocco termostato è abilitato |
type | https://developers.nest.com/reference/error-messages#lock-enabled |
message | Impossibile modificare la modalità HVAC mentre il blocco termostato è abilitato |
Impossibile impostare le temperature C e F contemporaneamente
Il prodotto ha tentato di impostare contemporaneamente la temperatura target di Celsius e Fahrenheit. Un prodotto deve impostare solo la temperatura target specificata da temperature_scale (C / F).
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Impossibile impostare le temperature C e F contemporaneamente |
type | https://developers.nest.com/reference/error-messages#multiple-value-changes |
message | Impossibile impostare le temperature C e F contemporaneamente |
Impossibile attivare / disattivare fan_timer_active a causa della modalità incompatibile
La ventola del sistema HVAC è già inserita (manualmente dall'utente o in base a un programma o a causa di un ciclo di riscaldamento / raffreddamento HVAC).
Se non ottieni il risultato previsto, è molto probabile che il dispositivo abbia un comportamento integrato che non possiamo ignorare tramite l'API.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Impossibile attivare / disattivare fan_timer_active a causa della modalità $mode incompatibile |
type | https://developers.nest.com/reference/error-messages#incompatible-fan-mode |
message | Impossibile attivare / disattivare fan_timer_active a causa della modalità $mode incompatibile |
details | $mode |
Impossibile impostare fan_timer_duration sul valore selezionato
Il prodotto ha tentato di impostare fan_timer_duration su un valore non valido. Vedi fan_timer_duration per un elenco di valori validi.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Impossibile impostare fan_timer_duration sul valore selezionato. Vedi riferimento 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. Vedi riferimento API per i valori consentiti. |
Impossibile impostare la temperatura target bassa su una temperatura target alta
Il termostato è in modalità di heat-cool a heat-cool e il prodotto ha tentato di impostare una temperatura target bassa / alta che non rientra nell'intervallo. Ad esempio, il prodotto ha tentato di impostare target_temperature_low_c a 25 ° C quando target_temperature_high_c è 24 ° C.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Impossibile impostare la temperatura target bassa $lowTemp superiore alla temperatura target alta $highTemp |
type | https://developers.nest.com/reference/error-messages#low-high-error |
message | Impossibile impostare la temperatura target bassa $lowTemp superiore alla temperatura target alta $highTemp |
details | $lowTemp |
Impossibile impostare la temperatura target più vicina di N gradi C / F
Il prodotto ha tentato di impostare un valore di temperatura target troppo vicino alla temperatura alta / bassa target (ad esempio, target_temperature_high_f ).
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Impossibile impostare la temperatura target più vicina di N gradi C / F |
type | https://developers.nest.com/reference/error-messages#range-error |
message | Impossibile impostare la temperatura target $scale inferiore a $min gradi $scale |
details | $min $scale |
Impossibile impostare target_temperature mentre mode è $ mode
Il termostato o la struttura è attualmente in una modalità che non supporta le richieste API.
Ad esempio, non è possibile impostare target_temperature_f o target_temperature_c quando il sistema HVAC è off o in modalità di heat-cool a heat-cool . Il valore non può essere modificato fino a quando il termostato / la struttura non ritornano in modalità non limitata.
In questo messaggio, $fieldName può essere uno qualsiasi dei valori di temperatura target e $mode può essere uno qualsiasi di: eco , emer_heat_enable , heat-cool , heat , cool , off , hvac_safety_shutoff_active .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Impossibile impostare target_temperature mentre mode è $mode |
type | https://developers.nest.com/reference/error-messages#mode-error |
message | Impossibile impostare $fieldName mentre mode è $mode |
details | $fieldName |
Aggiornamento del firmware del dispositivo richiesto prima di poter modificare la modalità HVAC
Il dispositivo deve essere aggiornato alla versione corrente del firmware per impostare le temperature ecologiche.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Aggiornamento del firmware del dispositivo richiesto prima di poter modificare la modalità HVAC. Gli aggiornamenti sono automatici, in genere entro una settimana dal rilascio. |
type | https://developers.nest.com/reference/error-messages#unsupported-firmware-version |
message | Aggiornamento del firmware del dispositivo richiesto prima di poter modificare la modalità HVAC. Gli aggiornamenti sono automatici, in genere entro una settimana dal rilascio. |
Errore durante la convalida dei campi WWN
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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 |
ETA è nel passato
Il tempo ETA specificato è passato (prima di NOW). Per ulteriori informazioni su come effettuare chiamate ETA, consultare la Guida assente ed ETA .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | ETA è nel passato: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
type | https://developers.nest.com/reference/error-messages#eta-in-the-past |
message | ETA è nel passato: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
details | $estimatedArrivalTime |
L'ETA è troppo lontano in futuro
Il tempo ETA specificato non può essere più di 8 ore in futuro. Per ulteriori informazioni su come effettuare chiamate ETA, consultare la Guida assente ed ETA .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | L'ETA è troppo lontano in futuro |
type | https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future |
message | L'ETA è troppo lontano in futuro |
fan_timer_active non impostato
fan_timer_active non è definito.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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 |
Vietato
Le credenziali utilizzate per accedere al servizio Nest non sono valide.
| parametri | |
|---|---|
| Codice di stato HTTP: 403 proibito | |
error | Vietato |
type | https://developers.nest.com/reference/error-messages#forbidden |
message | Vietato |
Errore interno
| parametri | |
|---|---|
| Codice di stato HTTP: 500 Errore interno del server | |
error | Errore interno |
type | https://developers.nest.com/reference/error-messages#internal-error |
message | Errore interno |
ID videocamera non valido
L' camera-id non è valido.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | ID telecamera $id non valido |
type | https://developers.nest.com/reference/error-messages#invalid-camera-id |
message | ID telecamera non valido: $id |
details | $id |
Contenuto non valido inviato
La chiamata contiene contenuti non validi. Ad esempio, utilizzando "yes" anziché "true" per una variabile booleana.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Contenuto non valido inviato |
type | https://developers.nest.com/reference/error-messages#invalid-content-sent |
message | Contenuto non valido inviato |
Percorso frammento non valido
Parte del percorso della richiesta non è valida. Ad esempio, un nome di oggetto o campo potrebbe essere errato.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Percorso frammento non valido: $requestPath |
type | https://developers.nest.com/reference/error-messages#invalid-fragment |
message | Percorso frammento non valido: $requestPath |
details | $requestPath |
Modalità HVAC non valida
Il sistema HVAC del termostato non supporta la modalità richiesta dal prodotto: heat , cool o heat-cool .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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 allarme fumo + co non valido
smoke_co_alarm_id non è valido.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | ID fumo + co allarme non valido $id |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | ID allarme fumo + co non valido: $id |
details | $id |
ID struttura non valido
La structure_id non è valida.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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
thermostat_id non è valido.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | ID termostato non valido $id |
type | https://developers.nest.com/reference/error-messages#invalid-thermostat-id |
message | ID termostato non valido: $id |
details | $id |
Valore non valido per Away
Hai provato a impostare un valore non valido per away .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Valore non valido per Away |
type | https://developers.nest.com/reference/error-messages#invalid-away-value |
message | Valore non valido: $value . Solo "home" e "away" sono valori consentiti. |
details | $value |
is_streaming non è booleano
Il prodotto ha tentato di impostare il campo is-streaming su un valore non booleano.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | is_streaming non è booleano |
type | https://developers.nest.com/reference/error-messages#invalid-is-stream-format |
message | is_streaming non è booleano |
L'etichetta deve contenere meno di 256 caratteri
Il prodotto ha tentato di creare un'etichetta termostato con più di 256 caratteri.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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 |
Personalizzazione massima in caso di superamento del conteggio
Il prodotto ha tentato di creare un oggetto di wheres personalizzato oltre il massimo. Il numero massimo di personalizzato wheres oggetti consentiti è di 32.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | $max_where_count superamento del conteggio di $max_where_count |
type | https://developers.nest.com/reference/error-messages#max-where-count |
message | $max_where_count superamento del conteggio di $max_where_count |
details | $max_where_count |
Personalizzazione massima in caso di superamento della lunghezza del nome
Il name cui è troppo lungo. Consigliamo meno di 30 caratteri.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | $max_custom_where_name_length massima in cui è $max_custom_where_name_length superata la lunghezza del nome di $max_custom_where_name_length |
type | https://developers.nest.com/reference/error-messages#max-where-name-length |
message | $max_custom_where_name_length superamento della lunghezza del nome di $max_custom_where_name_length |
details | $max_custom_where_name_length |
Campo mancante
Nella chiamata manca un parametro richiesto.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Campo mancante: $fieldName |
type | https://developers.nest.com/reference/error-messages#field-is-missing |
message | Campo mancante: $fieldName |
details | $fieldName |
ID mancante
where_id formato where_id .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | ID mancante |
type | https://developers.nest.com/reference/error-messages#where-id-missing |
message | ID mancante |
Nessuna ventola HVAC
Il sistema HVAC non sembra avere un ventilatore indipendente.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Nessun fan di hvac |
type | https://developers.nest.com/reference/error-messages#no-hvac-fan |
message | Nessun fan di hvac |
Nessun termostato online
Il termostato è attualmente offline. Dopo aver abilitato il Wi-Fi, il prodotto dovrebbe riottenere l'accesso.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Nessun termostato online |
type | https://developers.nest.com/reference/error-messages#no-thermostats-online |
message | Nessun termostato online |
Nessun dispositivo associato
I dispositivi Nest dell'utente non sono associati all'account Nest dell'utente .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Nessun dispositivo associato |
type | https://developers.nest.com/reference/error-messages#no-paired-devices |
message | Nessun dispositivo associato |
Nessun ETA valido da cancellare
Il viaggio non è valido e non può essere cancellato.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Nessun ETA valido da cancellare |
type | https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel |
message | Nessun ETA valido da cancellare |
Nessuna autorizzazione di scrittura per i campi
Il client non dispone dell'autorizzazione di scrittura per questi dati. Per ulteriori informazioni, consultare la panoramica delle autorizzazioni .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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 |
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: 400 richiesta 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à Assente
La struttura non è in modalità Assente quando viene effettuata una chiamata ETA. Le chiamate ETA sono accettate solo quando la struttura è impostata su Assente.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Non in modalità Assente |
type | https://developers.nest.com/reference/error-messages#not-in-away-mode |
message | Non in modalità Assente |
Non scrivibile
Il campo su cui stai tentando di scrivere è di sola lettura.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Non scrivibile |
type | https://developers.nest.com/reference/error-messages#not-writable |
message | Non scrivibile |
Solo dove è necessario fornire il nome
I campi extra sono stati inclusi nella chiamata wheres .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Solo dove è necessario fornire il nome |
type | https://developers.nest.com/reference/error-messages#extra-fields |
message | Solo dove è necessario fornire 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: 400 richiesta 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'associazione dei dispositivi.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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à consentito il numero massimo di dispositivi associati
La struttura ha già il numero massimo di dispositivi consentiti .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | La struttura ha già consentito il numero massimo di dispositivi associati |
type | https://developers.nest.com/reference/error-messages#max-number-devices-error |
message | La struttura ha già consentito il numero massimo di dispositivi associati |
La struttura non è di proprietà dell'utente
structure_id non corrisponde all'account utente del record.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | La struttura non è di proprietà dell'utente. |
type | https://developers.nest.com/reference/error-messages#structure-ownership-error-uri |
message | La struttura 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 target Celsius superiore all'intervallo di temperatura di blocco.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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 target Celsius inferiore all'intervallo di temperatura di blocco.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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 |
Il valore della temperatura C è troppo alto
Il prodotto ha tentato di impostare un valore di temperatura target troppo elevato per una temperatura Celsius. Per gli intervalli di temperatura consentiti in gradi Celsius, consultare target_temperature_c .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Il valore della temperatura C è troppo alto: $tempC |
type | https://developers.nest.com/reference/error-messages#high-c-value |
message | Il valore della temperatura C è troppo alto: $tempC |
details | $tempC |
Il valore della temperatura C è troppo basso
Il prodotto ha tentato di impostare un valore di temperatura target troppo basso per una temperatura Celsius. Per gli intervalli di temperatura consentiti in gradi Celsius, consultare target_temperature_c .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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 target di Fahrenheit superiore all'intervallo di temperatura di blocco.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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 target di Fahrenheit inferiore all'intervallo di temperatura di blocco.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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 target troppo elevato per una temperatura di Fahrenheit. Per gli intervalli di temperatura consentiti in Fahrenheit, consultare target_temperature_f .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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 target troppo basso per una temperatura Fahrenheit. Per gli intervalli di temperatura consentiti in Fahrenheit, consultare target_temperature_f .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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 |
La temperatura è nel formato sbagliato
Il prodotto ha tentato di impostare una temperatura target utilizzando il formato numerico errato per la temperature_scale selezionata. Le temperature Celsius dovrebbero essere numeri interi con incrementi di 0,5 gradi (21,5) e le temperature Fahrenheit dovrebbero essere numeri interi interi (72).
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | La temperatura $temp è nel formato errato |
type | https://developers.nest.com/reference/error-messages#format-error |
message | La temperatura $temp è nel formato errato |
details | $temp |
I campi non possono essere modificati durante l'aggiornamento
Il prodotto ha tentato di scrivere in un campo di sola lettura.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | I campi non possono essere modificati durante l'aggiornamento: $fieldNames |
type | https://developers.nest.com/reference/error-messages#read-only-field-error |
message | I campi non possono essere modificati durante l'aggiornamento: $fieldNames |
details | $fieldNames |
I campi devono utilizzare il formato ISO 8601
Il campo non è in formato ISO 8601 .
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | I campi devono usare il formato ISO 8601: $fieldNames |
type | https://developers.nest.com/reference/error-messages#time-format-error |
message | I campi devono usare il formato ISO 8601: $fieldNames |
details | $fieldNames |
Il termostato non è in linea
Il termostato è attualmente offline. Dopo aver abilitato la connessione Wi-Fi, il prodotto dovrebbe riottenere l'accesso.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Il termostato non è in linea |
type | https://developers.nest.com/reference/error-messages#not-online |
message | Il termostato non è in linea |
Questo viaggio è stato sostituito manualmente
L'utente ha sovrascritto manualmente il viaggio.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Questo viaggio è stato sostituito manualmente |
type | https://developers.nest.com/reference/error-messages#trip-manually-overidden |
message | Questo viaggio è stato sostituito manualmente |
Impossibile creare dove ID
Manca l'oggetto wheres . Nessun valore where_id definito.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Impossibile creare dove id |
type | https://developers.nest.com/reference/error-messages#wheres-missing |
message | Impossibile creare dove id |
non autorizzato
L'autorizzazione non è riuscita.
Un paio di condizioni possono generare questo messaggio di errore:
reindirizzamenti errati che si verificano quando una determinata implementazione HTTP non inoltra automaticamente l'intestazione dell'autorizzazione all'URI reindirizzato. Per ulteriori informazioni, vedere Come gestire i reindirizzamenti .
autorizzazioni errate quando si tenta di accedere agli endpoint API. Ad esempio, tentando di leggere un endpoint termostato quando sono selezionate solo le autorizzazioni della telecamera per il client. Per ulteriori informazioni, vedere 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: 400 richiesta non valida | |
error | sconosciuto |
type | https://developers.nest.com/reference/error-messages#unknown |
message | sconosciuto |
Venditore sconosciuto / tipo di dispositivo
Venditore / dispositivo non riconosciuto durante l'accoppiamento del dispositivo.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Venditore sconosciuto / tipo di dispositivo |
type | https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error |
message | Venditore sconosciuto / tipo di dispositivo |
Il valore di $ fieldName è di tipo errato
È stato inviato un tipo di dati errato. Ad esempio, l'invio di una stringa quando è previsto un valore booleano.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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 il nome esiste già
where_name il prodotto ha tentato di impostare esiste già. Riprova con un nuovo nome.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Dove nome $name esiste già |
type | https://developers.nest.com/reference/error-messages#where-name-exists |
message | Dove nome $name esiste già |
details | $name |
Dove il nome non è fornito
where_name è presente nella chiamata.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Dove il nome non è fornito |
type | https://developers.nest.com/reference/error-messages#where-name-missing |
message | Dove il nome non è fornito |
Dove il nome è di lunghezza zero
Il name cui non è definito (ha zero caratteri).
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Dove il nome è di lunghezza zero |
type | https://developers.nest.com/reference/error-messages#zero-length-where-name |
message | Dove il nome è di lunghezza zero |
Dove nome deve essere una stringa
È stato inviato un tipo di dati errato per where_name . Ad esempio, un numero quando è prevista una stringa.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta non valida | |
error | Dove nome deve essere una stringa |
type | https://developers.nest.com/reference/error-messages#where-name-wrong-format |
message | Dove nome deve essere una stringa |
dove_id non esiste
where_id non è valido.
| parametri | |
|---|---|
| Codice di stato HTTP: 400 richiesta 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: 400 richiesta 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 e messaggi di errore
Codici di errore del dispositivo
Per i codici di errore specifici del dispositivo e i messaggi non correlati all'API Nest, vedere quanto segue:
Codici di errore REST
Quando si effettua una chiamata all'API REST, vengono restituiti codici di stato HTTP comuni.
Messaggi limite di velocità REST
Quando si utilizza REST e si inviano troppe chiamate in un breve periodo di tempo, è possibile che venga visualizzato un codice di stato della risposta HTTP di 429 Troppe richieste.
Per ulteriori informazioni, consultare Limiti della velocità dei dati .