Fehlermeldungen

Fehlerbedingungen sind Teil des Entwicklungszyklus und können von einfachen Fehlern wie einem ungültigen oder fehlenden Parameter bis hin zu komplexeren Szenarien reichen, z. B. ein unerwarteter Status oder sogar gerätebezogene Einstellungen, die außerhalb der API behoben werden müssen.

Wenn während eines API-Aufrufs ein Fehler auftritt, wird eine Antwort im folgenden Format gesendet:

{
  "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"
  }
}

Alle Fehlermeldungen enthalten die Felder error, type, message und instance. Das details-Objekt ist optional.

Feld Beschreibung
error Kurze Fehlermeldung.
type Enthält eine URL zu detaillierten Informationen über den Fehlerzustand (diese Seite).
message Lange Fehlermeldung, in der Variablen zur Bereitstellung zusätzlicher Details verwendet werden können. Wenn eine Variable in die Nachricht enthalten ist, wird sie im Objekt details angezeigt.
instance Ein Textstring mit einer Fehlerkennung, die für jeden einzelnen Aufruf eindeutig ist. Wenn Sie ein Problem mit dem Dienst melden, werden Sie unter Umständen nach der Instanznummer gefragt.
details Optional. Enthält Variablen, die in das message eingefügt werden. Nachrichten können mehrere Variablen enthalten.

Informationen zu Fehlern, die nicht mit der Nest API zusammenhängen, findest du unter Weitere Fehlercodes und Fehlermeldungen.

Gesperrt

Das Ratenlimit wurde überschritten.

Parameter
HTTP-Statuscode:429 Zu viele Anfragen
errorGesperrt
typehttps://developers.nest.com/reference/error-messages#blocked
messageGesperrt

Lüfter kann während der Rauch-/Co-Sicherheitsabschaltung nicht aktiviert werden

Die Notabschaltung ist aktiviert. API-Aufrufe werden erst akzeptiert, wenn der normale Betrieb wiederhergestellt wurde.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorLüfter kann während der Rauch-/Co-Sicherheitsabschaltung nicht aktiviert werden
typehttps://developers.nest.com/reference/error-messages#safety-shutoff-on
messageLüfter kann während der Rauch-/Co-Sicherheitsabschaltung nicht aktiviert werden

„Abwesend“-Status kann nicht geändert werden, wenn die Heizung eingeschaltet ist

Das Produkt hat versucht, den Status „Abwesend“ zu ändern, während Notfallheizung aktiviert war.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
error„Abwesend“-Status kann nicht geändert werden, wenn die Heizung eingeschaltet ist
typehttps://developers.nest.com/reference/error-messages#emergency-heat-is-on
message„Abwesend“-Status kann nicht geändert werden, wenn die Heizung eingeschaltet ist

HLK-Modus kann während energiesparender Ereignisse nicht geändert werden

Es wird ein Energiesparereignis angewendet, das von einem Nest-Energiepartner definiert wurde. API-Aufrufe werden bis zum Ende des Energiesparmodus abgelehnt.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorHLK-Modus kann während energiesparender Ereignisse nicht geändert werden
typehttps://developers.nest.com/reference/error-messages#energy-saving-event-on
messageHLK-Modus kann während energiesparender Ereignisse nicht geändert werden

HLK-Modus kann nicht geändert werden

Der Modus ist nicht mit der Anfrage kompatibel.

Sie erhalten diese Meldung beispielsweise, wenn

  • Der HLK-System des Thermostats unterstützt den von deinem Produkt angeforderten Modus nicht: heat, cool, heat-cool oder eco
  • Der HLK-Modus ist auf eco festgelegt und das Produkt versucht, target_temperature festzulegen
Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorHLK-Modus kann nicht in $mode geändert werden; HLK kann $action nicht ändern
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
messageHLK-Modus kann nicht in $mode geändert werden; HLK kann $action nicht ändern
details$mode
$action

HLK-Modus kann nicht geändert werden, wenn die Thermostatsperre aktiviert ist

Der Nutzer muss den Thermostat entsperren, bevor ein Produkt Daten schreiben kann.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorHLK-Modus kann nicht geändert werden, wenn die Thermostatsperre aktiviert ist
typehttps://developers.nest.com/reference/error-messages#lock-enabled
messageHLK-Modus kann nicht geändert werden, wenn die Thermostatsperre aktiviert ist

C- und F-Temperaturen können nicht gleichzeitig eingestellt werden

Das Produkt hat versucht, gleichzeitig die Zieltemperaturen Celsius und Fahrenheit festzulegen. Ein Produkt sollte nur die Zieltemperatur festlegen, die durch temperature_scale (C/F) festgelegt wird.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorC- und F-Temperaturen können nicht gleichzeitig eingestellt werden
typehttps://developers.nest.com/reference/error-messages#multiple-value-changes
messageC- und F-Temperaturen können nicht gleichzeitig eingestellt werden

„Fan_timer_active“ kann nicht aktiviert werden, da der Modus nicht kompatibel ist

Der Lüfter des HLK-Systems ist bereits aktiv (entweder manuell durch den Nutzer, nach einem Zeitplan oder wegen eines Heiz-/Kühl-HLKs).

Wenn das erwartete Ergebnis nicht angezeigt wird, liegt das höchstwahrscheinlich daran, dass das Gerät ein Verhalten hat, das wir nicht über die API überschreiben können.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
error„Fan_timer_active“ kann nicht aktiviert werden, weil der Modus nicht kompatibel ist: $mode
typehttps://developers.nest.com/reference/error-messages#incompatible-fan-mode
message„Fan_timer_active“ kann nicht aktiviert werden, weil der Modus nicht kompatibel ist: $mode
details$mode

Für „fan_timer_duration“ kann der ausgewählte Wert nicht festgelegt werden

Das Produkt hat versucht, fan_timer_duration auf einen ungültigen Wert zu setzen. Unter fan_timer_duration findest du eine Liste der gültigen Werte.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorFür „fan_timer_duration“ kann der ausgewählte Wert nicht festgelegt werden. Informationen zu zulässigen Werten finden Sie in der API-Referenz.
typehttps://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
messageFür „fan_timer_duration“ kann der ausgewählte Wert nicht festgelegt werden. Informationen zu zulässigen Werten finden Sie in der API-Referenz.

Niedrige Zieltemperatur kann nicht als hohe Zieltemperatur eingestellt werden

Der Thermostat befindet sich im Modus heat-cool und das Produkt hat versucht, eine Zieltemperatur niedrig/hoch außerhalb des Bereichs festzulegen. Das Produkt hat beispielsweise versucht, target_temperature_low_c auf 25 °C zu setzen, wenn target_temperature_high_c 24 °C beträgt.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorZiel-Tiefsttemperatur $lowTemp kann nicht höher als Ziel-Höchsttemperatur $highTemp sein
typehttps://developers.nest.com/reference/error-messages#low-high-error
messageZiel-Tiefsttemperatur $lowTemp kann nicht höher als Ziel-Höchsttemperatur $highTemp sein
details$lowTemp
$highTemp

Zieltemperatur kann nicht näher als N Grad Celsius/F festgelegt werden

Das Produkt hat versucht, einen Zieltemperaturwert zu nah an der Zielhoch-/Tiefsttemperatur (z. B. target_temperature_high_f) anzusetzen.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorZieltemperatur kann nicht näher als N Grad Celsius/F festgelegt werden
typehttps://developers.nest.com/reference/error-messages#range-error
messageZieltemperatur kann nicht näher als $min Grad $scale liegen
details$min
$scale

target_temperature kann nicht im Modus $$ festgelegt werden

Der Thermostat oder die Struktur befindet sich derzeit in einem Modus, der API-Anfragen nicht unterstützt.

Du kannst beispielsweise target_temperature_f oder target_temperature_c nicht festlegen, wenn das HLK-System off oder im heat-cool-Modus ist. Der Wert kann erst geändert werden, wenn der Thermostat/die Struktur wieder in einen nicht eingeschränkten Modus wechselt.

In dieser Nachricht kann $fieldName ein beliebiger Zieltemperaturwert sein und $mode kann einer der folgenden sein: eco, emer_heat_enable, heat-cool, heat, cool, off oder hvac_safety_shutoff_active.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errortarget_temperature kann nicht im Modus"$mode"festgelegt werden
typehttps://developers.nest.com/reference/error-messages#mode-error
message$fieldName kann nicht festgelegt werden, wenn der Modus $mode ist
details$fieldName
$mode

Firmwareupdate des Geräts ist erforderlich, bevor du den HLK-Modus ändern kannst

Das Gerät muss auf die aktuelle Firmwareversion aktualisiert werden, um Eco-Temperaturen festzulegen.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorDein Gerät muss aktualisiert werden, bevor du den HLK-Modus ändern kannst. Updates werden automatisch installiert, in der Regel innerhalb einer Woche nach dem Release.
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
messageDein Gerät muss aktualisiert werden, bevor du den HLK-Modus ändern kannst. Updates werden automatisch installiert, in der Regel innerhalb einer Woche nach dem Release.

Fehler beim Validieren der WWN-Felder

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorFehler beim Validieren der WWN-Felder: $error
typehttps://developers.nest.com/reference/error-messages#where-id-internal
messageFehler beim Validieren der WWN-Felder: $error
details$error

Die voraussichtliche Ankunftszeit liegt in der Vergangenheit.

Die angegebene voraussichtliche Ankunftszeit liegt in der Vergangenheit (vor NOW). Weitere Informationen zu ETA-Aufrufen findest du im ETA-Leitfaden für „Abwesend“.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorDie voraussichtliche Ankunftszeit liegt in der Vergangenheit: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
typehttps://developers.nest.com/reference/error-messages#eta-in-the-past
messageDie voraussichtliche Ankunftszeit liegt in der Vergangenheit: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details$estimatedArrivalTime
$currentTime

Die voraussichtliche Ankunftszeit liegt in der Zukunft

Die angegebene Ankunftszeit muss mindestens 8 Stunden in der Zukunft liegen. Weitere Informationen zu ETA-Anrufen findest du im Leitfaden für „Abwesend“; ETA.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorDie voraussichtliche Ankunftszeit ist in der Zukunft zu weit.
typehttps://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
messageDie voraussichtliche Ankunftszeit ist in der Zukunft zu weit.

Lüfterdauer_nicht festgelegt

fan_timer_active ist nicht definiert.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorLüfterdauer_nicht festgelegt
typehttps://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
messageLüfterdauer_nicht festgelegt

Unzulässig

Die für den Nest-Dienst verwendeten Anmeldedaten sind ungültig.

Parameter
HTTP-Statuscode: 403 Unzulässig
errorUnzulässig
typehttps://developers.nest.com/reference/error-messages#forbidden
messageUnzulässig

Interner Fehler

Parameter
HTTP-Statuscode: 500 Interner Serverfehler
errorInterner Fehler
typehttps://developers.nest.com/reference/error-messages#internal-error
messageInterner Fehler

Ungültige Kamera-ID

Das camera-id-Element ist ungültig.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorUngültige Kamera-ID $id
typehttps://developers.nest.com/reference/error-messages#invalid-camera-id
messageUngültige Kamera-ID: $id
details$id

Ungültige Inhalte gesendet

Der Anruf enthält ungültige Inhalte. Beispiel: Wird für eine boolesche Variable „&yes“ statt „true“ verwendet.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorUngültige Inhalte gesendet
typehttps://developers.nest.com/reference/error-messages#invalid-content-sent
messageUngültige Inhalte gesendet

Ungültiger Fragmentpfad

Ein Teil des Anfragepfads ist ungültig. Beispielsweise kann ein Objekt- oder Feldname falsch geschrieben sein.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorUngültiger Fragmentpfad: $requestPath
typehttps://developers.nest.com/reference/error-messages#invalid-fragment
messageUngültiger Fragmentpfad: $requestPath
details$requestPath

Ungültiger HLK-Modus

Der HLK-System des Thermostats unterstützt den vom Produkt angeforderten Modus nicht: heat, cool oder heat-cool.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorUngültiger HLK-Modus: $mode
typehttps://developers.nest.com/reference/error-messages#invalid-mode
messageUngültiger HLK-Modus: $mode
details$mode

Ungültige Rauch- & Kohlenmonoxidalarm-ID

Das smoke_co_alarm_id-Element ist ungültig.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorUngültige Rauch- & Kohlenmonoxidalarm-ID $id
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
messageUngültige ID für Rauch- und Kohlenmonoxidalarm: $id
details$id

Ungültige Gebäude-ID

Das structure_id-Element ist ungültig.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorUngültige Gebäude-ID: $id
typehttps://developers.nest.com/reference/error-messages#invalid-structure-id
messageUngültige Struktur-ID: $id
details$id

Ungültige Thermostat-ID

Das thermostat_id-Element ist ungültig.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorUngültige Thermostat-ID: $id
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
messageUngültige Thermostat-ID: $id
details$id

Ungültiger Wert für „Abwesend“

Sie haben einen ungültigen Wert für away festgelegt.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorUngültiger Wert für „Abwesend“
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
messageUngültiger Wert: $value. Nur &„Zuhause“ und „39; Zuhause“ sind zulässig.
details$value

is_streaming ist kein boolescher Wert

Das Produkt hat versucht, für das Feld is-streaming einen nicht booleschen Wert festzulegen.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
erroris_streaming ist kein boolescher Wert
typehttps://developers.nest.com/reference/error-messages#invalid-is-stream-format
messageis_streaming ist kein boolescher Wert

Das Label muss weniger als 256 Zeichen enthalten

Das Produkt hat versucht, ein Thermostat-Label mit mehr als 256 Zeichen zu erstellen.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorDas Label muss weniger als $max_label_length Zeichen umfassen
typehttps://developers.nest.com/reference/error-messages#max-label-length
messageDas Label muss weniger als $max_label_length Zeichen enthalten
details$max_label_length

Maximale Anzahl benutzerdefinierter Elemente, bei denen die Anzahl überschritten wurde

Das Produkt hat versucht, ein benutzerdefiniertes wheres-Objekt zu erstellen, das über das Maximum hinausgeht. Es sind maximal 32 benutzerdefinierte wheres-Objekte zulässig.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorMaximale benutzerdefinierte Anzahl von $max_where_count überschritten
typehttps://developers.nest.com/reference/error-messages#max-where-count
messageMaximale benutzerdefinierte Anzahl von $max_where_count überschritten
details$max_where_count

Maximale Anzahl benutzerdefinierter Namen, bei denen die Länge des Namens überschritten wurde

Dabei ist name zu lang. Wir empfehlen weniger als 30 Zeichen.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorMax. benutzerdefinierte Bezeichnung, bei der die Namenslänge von $max_custom_where_name_length überschritten wurde
typehttps://developers.nest.com/reference/error-messages#max-where-name-length
messageMax. benutzerdefinierte Bezeichnung, bei der die Namenslänge von $max_custom_where_name_length überschritten wurde
details$max_custom_where_name_length

Fehlendes Feld

Für den Aufruf fehlt ein erforderlicher Parameter.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorFehlendes Feld: $fieldName
typehttps://developers.nest.com/reference/error-messages#field-is-missing
messageFehlendes Feld: $fieldName
details$fieldName

Fehlende Wo-ID

Das Format where_id fehlt.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorFehlende wo-ID
typehttps://developers.nest.com/reference/error-messages#where-id-missing
messageFehlende wo-ID

Kein Lüfter der HLK-Anlage

Das HLK-System hat keinen unabhängigen Lüfter.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorKein Lüfter (HLK)
typehttps://developers.nest.com/reference/error-messages#no-hvac-fan
messageKein Lüfter (HLK)

Keine Online-Thermostate

Der Thermostat ist momentan offline. Nach der Aktivierung des WLANs sollte dein Produkt wieder Zugriff erhalten.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorKeine Online-Thermostate
typehttps://developers.nest.com/reference/error-messages#no-thermostats-online
messageKeine Online-Thermostate

Keine gekoppelten Geräte

Die Nest-Geräte des Nutzers sind nicht mit dem Nest-Konto des Nutzers gekoppelt.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorKeine gekoppelten Geräte
typehttps://developers.nest.com/reference/error-messages#no-paired-devices
messageKeine gekoppelten Geräte

Keine gültige voraussichtliche Ankunftszeit

Die Fahrt ist ungültig und kann nicht storniert werden.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorKeine gültige voraussichtliche Ankunftszeit
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageKeine gültige voraussichtliche Ankunftszeit

Keine Schreibberechtigung für Feld(e)

Der Client hat keine Schreibberechtigung für diese Daten. Weitere Informationen finden Sie unter Berechtigungen.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorKeine Schreibberechtigung für Felder: $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
messageKeine Schreibberechtigung für Felder: $fields
details$fields

Kein gültiger Anfragetyp

Der Anfragetyp ist ungültig. Beispiel: Ein POST-Aufruf wurde ausgeführt, wenn ein PUT-Aufruf erforderlich ist.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorKein gültiger Anfragetyp: $requestType
typehttps://developers.nest.com/reference/error-messages#request-type-not-allowed
messageKein gültiger Anfragetyp: $requestType
details$requestType

Nicht gefunden

Beim Aufruf wurde versucht, einen Pfad zu lesen, der nicht vorhanden ist.

Parameter
HTTP-Statuscode: 404 Nicht gefunden
errorNicht gefunden
typehttps://developers.nest.com/reference/error-messages#not-found
messageNicht gefunden

Nicht im Modus „Abwesend“

Die Struktur befindet sich nicht im Modus „Abwesend“, wenn ein ETA-Aufruf erfolgt. ETA-Aufrufe werden nur akzeptiert, wenn die Struktur auf „Abwesend“ eingestellt ist.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorNicht im Modus „Abwesend“
typehttps://developers.nest.com/reference/error-messages#not-in-away-mode
messageNicht im Modus „Abwesend“

Nicht bearbeitbar

Das Feld, in das Sie schreiben möchten, ist schreibgeschützt.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorNicht bearbeitbar
typehttps://developers.nest.com/reference/error-messages#not-writable
messageNicht bearbeitbar

Nur wenn der Name angegeben werden muss

Der wheres-Aufruf enthält zusätzliche Felder.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorNur wenn der Name angegeben werden muss
typehttps://developers.nest.com/reference/error-messages#extra-fields
messageNur wenn der Name angegeben werden muss

POST ist kein gültiger Anfragetyp

Der Anfragetyp ist ungültig. Beispiel: Ein POST-Aufruf wurde ausgeführt, wenn ein PUT-Aufruf erforderlich ist.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorPOST ist kein gültiger Anfragetyp
typehttps://developers.nest.com/reference/error-messages#invalid-request-type
messagePOST ist kein gültiger Anfragetyp

Schemaverstoß

Beim Koppeln der Geräte ist ein Fehler aufgetreten.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorSchemaverstoß
typehttps://developers.nest.com/reference/error-messages#schema-violation-error
messageSchemaverstoß

Dienst nicht verfügbar

Parameter
HTTP-Statuscode:503 Dienst nicht verfügbar
errorService Unavailable (Dienst nicht verfügbar)
typehttps://developers.nest.com/reference/error-messages#service-unavailable
messageService Unavailable (Dienst nicht verfügbar)

Für die Struktur ist bereits die maximal zulässige Anzahl von gekoppelten Geräten erreicht

Die Struktur hat bereits die maximale Anzahl zulässiger Geräte.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorFür die Struktur ist bereits die maximal zulässige Anzahl von gekoppelten Geräten erreicht
typehttps://developers.nest.com/reference/error-messages#max-number-devices-error
messageFür die Struktur ist bereits die maximal zulässige Anzahl von gekoppelten Geräten erreicht

Die Struktur gehört nicht dem Nutzer

Die structure_id stimmt nicht mit dem angegebenen Nutzerkonto überein.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorDie Struktur gehört nicht dem Nutzer.
typehttps://developers.nest.com/reference/error-messages#structure-ownership-error-uri
messageDie Struktur gehört nicht dem Nutzer.

Temperatur C ist zu hoch für die Sperrtemperatur

Der Thermostat wurde vom Nutzer gesperrt und das Produkt hat versucht, eine Zieltemperatur von Celsius höher als den Sperrtemperaturbereich festzulegen.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorTemperatur C $tempC ist zu hoch für die Sperrtemperatur $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-c-value-4-lock
messageTemperatur C $tempC ist zu hoch für die Sperrtemperatur $highLockTemp
details$tempC
$highLockTemp

Temperatur C ist zu niedrig für Sperrtemperatur

Der Thermostat wurde vom Nutzer gesperrt und das Produkt hat versucht, eine Zieltemperatur von Celsius unter den Sperrtemperaturbereich zu setzen.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorTemperatur C $tempC ist zu niedrig für Sperrtemperatur $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-c-value-4-lock
messageTemperatur C $tempC ist zu niedrig für Sperrtemperatur $lowLockTemp
details$tempC
$lowLockTemp

Temperatur-C-Wert zu hoch

Das Produkt hat versucht, einen Zieltemperaturwert festzulegen, der für eine Celsius-Temperatur zu hoch ist. Zulässige Temperaturbereiche in Celsius finden Sie unter target_temperature_c.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorTemperatur-C-Wert ist zu hoch: $tempC
typehttps://developers.nest.com/reference/error-messages#high-c-value
messageTemperatur-C-Wert ist zu hoch: $tempC
details$tempC

Temperatur-C-Wert zu niedrig

Das Produkt hat versucht, einen Zieltemperaturwert festzulegen, der zu niedrig für eine Celsius-Temperatur ist. Zulässige Temperaturbereiche in Celsius finden Sie unter target_temperature_c.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorTemperatur-C-Wert ist zu niedrig: $tempC
typehttps://developers.nest.com/reference/error-messages#low-c-value
messageTemperatur-C-Wert ist zu niedrig: $tempC
details$tempC

Temperatur F ist zu hoch für die Sperrtemperatur

Der Thermostat wurde vom Nutzer gesperrt und das Produkt hat versucht, eine Fahrenheit-Zieltemperatur höher als den Sperrtemperaturbereich festzulegen.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorTemperatur F $tempF ist zu hoch für die Sperrtemperatur $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-f-value-4-lock
messageTemperatur F $tempF ist zu hoch für die Sperrtemperatur $highLockTemp
details$tempF
$highLockTemp

Temperatur F ist zu niedrig für Sperrtemperatur

Der Thermostat wurde vom Nutzer gesperrt und das Produkt hat versucht, eine Fahrenheit-Zieltemperatur niedriger als den Sperrtemperaturbereich festzulegen.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorTemperatur F $tempF ist zu niedrig für die Sperrtemperatur $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-f-value-4-lock
messageTemperatur F $tempF ist zu niedrig für die Sperrtemperatur $lowLockTemp
details$tempF
$lowLockTemp

Temperatur-F-Wert zu hoch

Das Produkt hat versucht, einen Zieltemperaturwert festzulegen, der für eine Fahrentemperatur zu hoch ist. Zulässige Temperaturbereiche in Fahrenheit finden Sie unter target_temperature_f.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorTemperatur F ist zu hoch: $tempF
typehttps://developers.nest.com/reference/error-messages#high-f-value
messageTemperatur F ist zu hoch: $tempF
details$tempF

Temperatur-F-Wert zu niedrig

Das Produkt hat versucht, einen Zieltemperaturwert festzulegen, der für eine Fahrentemperatur zu niedrig ist. Zulässige Temperaturbereiche in Fahrenheit finden Sie unter target_temperature_f.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorTemperatur F ist zu niedrig: $tempF
typehttps://developers.nest.com/reference/error-messages#low-f-value
messageTemperatur F ist zu niedrig: $tempF
details$tempF

Temperatur hat das falsche Format

Das Produkt hat versucht, eine Zieltemperatur mit dem falschen Zahlenformat für die ausgewählte temperature_scale festzulegen. Celsius-Temperaturen sollten Ganzzahlen in 0,5-Grad-Schritten (21,5) sein, während Fahrenheit-Ganzzahlen ganze Zahlen (72) sein müssen.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorTemperatur: $temp hat das falsche Format
typehttps://developers.nest.com/reference/error-messages#format-error
messageTemperatur: $temp hat das falsche Format
details$temp

Die Felder können bei der Aktualisierung nicht geändert werden

Das Produkt hat versucht, in ein schreibgeschütztes Feld zu schreiben.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorDie Felder können bei der Aktualisierung nicht geändert werden: $fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
messageDie Felder können bei der Aktualisierung nicht geändert werden: $fieldNames
details$fieldNames

Die Felder müssen dem Format ISO 8601 entsprechen

Das Feld hat kein ISO 8601-Format.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorDie Felder müssen dem ISO 8601-Format entsprechen: $fieldNames
typehttps://developers.nest.com/reference/error-messages#time-format-error
messageDie Felder müssen dem ISO 8601-Format entsprechen: $fieldNames
details$fieldNames

Thermostat ist nicht online

Der Thermostat ist momentan offline. Nach der Aktivierung des WLANs sollte dein Produkt wieder Zugriff erhalten.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorThermostat ist nicht online
typehttps://developers.nest.com/reference/error-messages#not-online
messageThermostat ist nicht online

Diese Reise wurde manuell überschrieben

Der Nutzer hat die Fahrt manuell überschrieben.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorDiese Reise wurde manuell überschrieben
typehttps://developers.nest.com/reference/error-messages#trip-manually-overidden
messageDiese Reise wurde manuell überschrieben

Ort kann nicht erstellt werden

Das wheres-Objekt fehlt. Es sind keine where_id-Werte definiert.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorWo kann die ID erstellt werden?
typehttps://developers.nest.com/reference/error-messages#wheres-missing
messageWo kann die ID erstellt werden?

Nicht autorisiert

Fehler bei der Autorisierung.

Diese Fehlermeldung kann durch verschiedene Bedingungen verursacht werden:

  • Falsche Weiterleitungen, die auftreten, wenn eine bestimmte HTTP-Implementierung den Autorisierungsheader nicht automatisch an den weitergeleiteten URI weiterleitet. Weitere Informationen findest du unter Umgang mit Weiterleitungen.

  • Falsche Berechtigungen für den Zugriff auf API-Endpunkte. Beispiel: Versuch, einen Thermostat-Endpunkt zu lesen, wenn nur Kameraberechtigungen für den Client ausgewählt wurden. Weitere Informationen finden Sie unter Berechtigungen auswählen.

Parameter
HTTP-Statuscode: 401 – nicht autorisiert
errorNicht autorisiert
typehttps://developers.nest.com/reference/error-messages#auth-error
messageNicht autorisiert

Unbekannt

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorunbekannt
typehttps://developers.nest.com/reference/error-messages#unknown
messageunbekannt

Unbekannter Anbieter/Gerätetyp

Anbieter/Gerät wurde während der Gerätekopplung nicht erkannt.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorUnbekannter Anbieter/Gerätetyp
typehttps://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
messageUnbekannter Anbieter/Gerätetyp

Der Wert des Felds "$fieldName" hat den falschen Typ.

Der falsche Datentyp wurde gesendet. Beispiel: Wenn ein String gesendet wird, wenn ein boolescher Wert erwartet wird.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorDer Wert von $fieldName weist den falschen Typ auf
typehttps://developers.nest.com/reference/error-messages#wrong-data-type
messageDer Wert von $fieldName weist den falschen Typ auf
details$fieldName

Bereits vorhandener Name

Die where_name, die das Produkt einrichten wollte, ist bereits vorhanden. Versuch es noch einmal mit einem neuen Namen.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorWo der Name $name bereits vorhanden ist
typehttps://developers.nest.com/reference/error-messages#where-name-exists
messageWo der Name $name bereits vorhanden ist
details$name

Wenn kein Name angegeben ist

where_name fehlt in dem Anruf.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorWenn kein Name angegeben ist
typehttps://developers.nest.com/reference/error-messages#where-name-missing
messageWenn kein Name angegeben ist

Wenn der Name keine Länge hat

Dabei ist name nicht definiert (hat null Zeichen).

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorWenn der Name keine Länge hat
typehttps://developers.nest.com/reference/error-messages#zero-length-where-name
messageWenn der Name keine Länge hat

Wobei der Name ein String sein muss

Der falsche Datentyp wurde für where_name gesendet. Das ist beispielsweise eine Zahl, bei der ein String erwartet wird.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorWobei der Name ein String sein muss
typehttps://developers.nest.com/reference/error-messages#where-name-wrong-format
messageWobei der Name ein String sein muss

wo ist die ID nicht vorhanden

Das where_id-Element ist ungültig.

Parameter
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage)
errorwo ist die ID nicht vorhanden
typehttps://developers.nest.com/reference/error-messages#where-id-invalid
messagewo ist die ID nicht vorhanden
details$where_id

wo_id muss ein String sein

Das Format where_id ist ungültig. So wurde beispielsweise statt eines Strings eine Zahl gesendet.

Parameter
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage)
errorwo_id muss ein String sein
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messagewo_id muss ein String sein

Andere Fehlercodes und Fehlermeldungen

Gerätefehlercodes

Weitere Informationen zu gerätespezifischen Fehlercodes und Nachrichten finden Sie hier:

REST-Fehlercodes

Wenn Sie einen REST API-Aufruf ausführen, werden gängige HTTP-Statuscodes zurückgegeben.

Nachrichten zur REST-Ratenbegrenzung

Wenn Sie REST verwenden und innerhalb kurzer Zeit zu viele Aufrufe senden, erhalten Sie möglicherweise den HTTP-Antwortstatuscode 429 Zu viele Anfragen.

Weitere Informationen finden Sie unter Ratenbegrenzungen für Daten.