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 | |
error | Gesperrt |
type | https://developers.nest.com/reference/error-messages#blocked |
message | Gesperrt |
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) | |
error | Lüfter kann während der Rauch-/Co-Sicherheitsabschaltung nicht aktiviert werden |
type | https://developers.nest.com/reference/error-messages#safety-shutoff-on |
message | Lü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 |
type | https://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) | |
error | HLK-Modus kann während energiesparender Ereignisse nicht geändert werden |
type | https://developers.nest.com/reference/error-messages#energy-saving-event-on |
message | HLK-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
odereco
- Der HLK-Modus ist auf
eco
festgelegt und das Produkt versucht,target_temperature
festzulegen
Parameter | |
---|---|
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage) | |
error | HLK-Modus kann nicht in $mode geändert werden; HLK kann $action nicht ändern |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | HLK-Modus kann nicht in $mode geändert werden; HLK kann $action nicht ändern |
details | $mode |
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) | |
error | HLK-Modus kann nicht geändert werden, wenn die Thermostatsperre aktiviert ist |
type | https://developers.nest.com/reference/error-messages#lock-enabled |
message | HLK-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) | |
error | C- und F-Temperaturen können nicht gleichzeitig eingestellt werden |
type | https://developers.nest.com/reference/error-messages#multiple-value-changes |
message | C- 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 |
type | https://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) | |
error | Für „fan_timer_duration“ kann der ausgewählte Wert nicht festgelegt werden. Informationen zu zulässigen Werten finden Sie in der API-Referenz. |
type | https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration |
message | Fü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) | |
error | Ziel-Tiefsttemperatur $lowTemp kann nicht höher als Ziel-Höchsttemperatur $highTemp sein |
type | https://developers.nest.com/reference/error-messages#low-high-error |
message | Ziel-Tiefsttemperatur $lowTemp kann nicht höher als Ziel-Höchsttemperatur $highTemp sein |
details | $lowTemp |
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) | |
error | Zieltemperatur kann nicht näher als N Grad Celsius/F festgelegt werden |
type | https://developers.nest.com/reference/error-messages#range-error |
message | Zieltemperatur 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) | |
error | target_temperature kann nicht im Modus"$mode "festgelegt werden |
type | https://developers.nest.com/reference/error-messages#mode-error |
message | $fieldName kann nicht festgelegt werden, wenn der Modus $mode ist |
details | $fieldName |
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) | |
error | Dein 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. |
type | https://developers.nest.com/reference/error-messages#unsupported-firmware-version |
message | Dein 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) | |
error | Fehler beim Validieren der WWN-Felder: $error |
type | https://developers.nest.com/reference/error-messages#where-id-internal |
message | Fehler 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) | |
error | Die voraussichtliche Ankunftszeit liegt in der Vergangenheit: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
type | https://developers.nest.com/reference/error-messages#eta-in-the-past |
message | Die voraussichtliche Ankunftszeit liegt in der Vergangenheit: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
details | $estimatedArrivalTime |
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) | |
error | Die voraussichtliche Ankunftszeit ist in der Zukunft zu weit. |
type | https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future |
message | Die 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) | |
error | Lüfterdauer_nicht festgelegt |
type | https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing |
message | Lüfterdauer_nicht festgelegt |
Unzulässig
Die für den Nest-Dienst verwendeten Anmeldedaten sind ungültig.
Parameter | |
---|---|
HTTP-Statuscode: 403 Unzulässig | |
error | Unzulässig |
type | https://developers.nest.com/reference/error-messages#forbidden |
message | Unzulässig |
Interner Fehler
Parameter | |
---|---|
HTTP-Statuscode: 500 Interner Serverfehler | |
error | Interner Fehler |
type | https://developers.nest.com/reference/error-messages#internal-error |
message | Interner Fehler |
Ungültige Kamera-ID
Das camera-id
-Element ist ungültig.
Parameter | |
---|---|
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage) | |
error | Ungültige Kamera-ID $id |
type | https://developers.nest.com/reference/error-messages#invalid-camera-id |
message | Ungü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) | |
error | Ungültige Inhalte gesendet |
type | https://developers.nest.com/reference/error-messages#invalid-content-sent |
message | Ungü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) | |
error | Ungültiger Fragmentpfad: $requestPath |
type | https://developers.nest.com/reference/error-messages#invalid-fragment |
message | Ungü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) | |
error | Ungültiger HLK-Modus: $mode |
type | https://developers.nest.com/reference/error-messages#invalid-mode |
message | Ungü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) | |
error | Ungültige Rauch- & Kohlenmonoxidalarm-ID $id |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | Ungü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) | |
error | Ungültige Gebäude-ID: $id |
type | https://developers.nest.com/reference/error-messages#invalid-structure-id |
message | Ungü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) | |
error | Ungültige Thermostat-ID: $id |
type | https://developers.nest.com/reference/error-messages#invalid-thermostat-id |
message | Ungü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) | |
error | Ungültiger Wert für „Abwesend“ |
type | https://developers.nest.com/reference/error-messages#invalid-away-value |
message | Ungü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) | |
error | is_streaming ist kein boolescher Wert |
type | https://developers.nest.com/reference/error-messages#invalid-is-stream-format |
message | is_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) | |
error | Das Label muss weniger als $max_label_length Zeichen umfassen |
type | https://developers.nest.com/reference/error-messages#max-label-length |
message | Das 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) | |
error | Maximale benutzerdefinierte Anzahl von $max_where_count überschritten |
type | https://developers.nest.com/reference/error-messages#max-where-count |
message | Maximale 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) | |
error | Max. benutzerdefinierte Bezeichnung, bei der die Namenslänge von $max_custom_where_name_length überschritten wurde |
type | https://developers.nest.com/reference/error-messages#max-where-name-length |
message | Max. 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) | |
error | Fehlendes Feld: $fieldName |
type | https://developers.nest.com/reference/error-messages#field-is-missing |
message | Fehlendes Feld: $fieldName |
details | $fieldName |
Fehlende Wo-ID
Das Format where_id
fehlt.
Parameter | |
---|---|
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage) | |
error | Fehlende wo-ID |
type | https://developers.nest.com/reference/error-messages#where-id-missing |
message | Fehlende 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) | |
error | Kein Lüfter (HLK) |
type | https://developers.nest.com/reference/error-messages#no-hvac-fan |
message | Kein 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) | |
error | Keine Online-Thermostate |
type | https://developers.nest.com/reference/error-messages#no-thermostats-online |
message | Keine 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) | |
error | Keine gekoppelten Geräte |
type | https://developers.nest.com/reference/error-messages#no-paired-devices |
message | Keine 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) | |
error | Keine gültige voraussichtliche Ankunftszeit |
type | https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel |
message | Keine 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) | |
error | Keine Schreibberechtigung für Felder: $fields |
type | https://developers.nest.com/reference/error-messages#no-write-permission |
message | Keine 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) | |
error | Kein gültiger Anfragetyp: $requestType |
type | https://developers.nest.com/reference/error-messages#request-type-not-allowed |
message | Kein 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 | |
error | Nicht gefunden |
type | https://developers.nest.com/reference/error-messages#not-found |
message | Nicht 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) | |
error | Nicht im Modus „Abwesend“ |
type | https://developers.nest.com/reference/error-messages#not-in-away-mode |
message | Nicht 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) | |
error | Nicht bearbeitbar |
type | https://developers.nest.com/reference/error-messages#not-writable |
message | Nicht 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) | |
error | Nur wenn der Name angegeben werden muss |
type | https://developers.nest.com/reference/error-messages#extra-fields |
message | Nur 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) | |
error | POST ist kein gültiger Anfragetyp |
type | https://developers.nest.com/reference/error-messages#invalid-request-type |
message | POST ist kein gültiger Anfragetyp |
Schemaverstoß
Beim Koppeln der Geräte ist ein Fehler aufgetreten.
Parameter | |
---|---|
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage) | |
error | Schemaverstoß |
type | https://developers.nest.com/reference/error-messages#schema-violation-error |
message | Schemaverstoß |
Dienst nicht verfügbar
Parameter | |
---|---|
HTTP-Statuscode:503 Dienst nicht verfügbar | |
error | Service Unavailable (Dienst nicht verfügbar) |
type | https://developers.nest.com/reference/error-messages#service-unavailable |
message | Service 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) | |
error | Für die Struktur ist bereits die maximal zulässige Anzahl von gekoppelten Geräten erreicht |
type | https://developers.nest.com/reference/error-messages#max-number-devices-error |
message | Fü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) | |
error | Die Struktur gehört nicht dem Nutzer. |
type | https://developers.nest.com/reference/error-messages#structure-ownership-error-uri |
message | Die 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) | |
error | Temperatur C $tempC ist zu hoch für die Sperrtemperatur $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-c-value-4-lock |
message | Temperatur C $tempC ist zu hoch für die Sperrtemperatur $highLockTemp |
details | $tempC |
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) | |
error | Temperatur C $tempC ist zu niedrig für Sperrtemperatur $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-c-value-4-lock |
message | Temperatur C $tempC ist zu niedrig für Sperrtemperatur $lowLockTemp |
details | $tempC |
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) | |
error | Temperatur-C-Wert ist zu hoch: $tempC |
type | https://developers.nest.com/reference/error-messages#high-c-value |
message | Temperatur-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) | |
error | Temperatur-C-Wert ist zu niedrig: $tempC |
type | https://developers.nest.com/reference/error-messages#low-c-value |
message | Temperatur-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) | |
error | Temperatur F $tempF ist zu hoch für die Sperrtemperatur $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-f-value-4-lock |
message | Temperatur F $tempF ist zu hoch für die Sperrtemperatur $highLockTemp |
details | $tempF |
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) | |
error | Temperatur F $tempF ist zu niedrig für die Sperrtemperatur $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-f-value-4-lock |
message | Temperatur F $tempF ist zu niedrig für die Sperrtemperatur $lowLockTemp |
details | $tempF |
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) | |
error | Temperatur F ist zu hoch: $tempF |
type | https://developers.nest.com/reference/error-messages#high-f-value |
message | Temperatur 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) | |
error | Temperatur F ist zu niedrig: $tempF |
type | https://developers.nest.com/reference/error-messages#low-f-value |
message | Temperatur 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) | |
error | Temperatur: $temp hat das falsche Format |
type | https://developers.nest.com/reference/error-messages#format-error |
message | Temperatur: $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) | |
error | Die Felder können bei der Aktualisierung nicht geändert werden: $fieldNames |
type | https://developers.nest.com/reference/error-messages#read-only-field-error |
message | Die 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) | |
error | Die Felder müssen dem ISO 8601-Format entsprechen: $fieldNames |
type | https://developers.nest.com/reference/error-messages#time-format-error |
message | Die 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) | |
error | Thermostat ist nicht online |
type | https://developers.nest.com/reference/error-messages#not-online |
message | Thermostat ist nicht online |
Diese Reise wurde manuell überschrieben
Der Nutzer hat die Fahrt manuell überschrieben.
Parameter | |
---|---|
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage) | |
error | Diese Reise wurde manuell überschrieben |
type | https://developers.nest.com/reference/error-messages#trip-manually-overidden |
message | Diese 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) | |
error | Wo kann die ID erstellt werden? |
type | https://developers.nest.com/reference/error-messages#wheres-missing |
message | Wo 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 | |
error | Nicht autorisiert |
type | https://developers.nest.com/reference/error-messages#auth-error |
message | Nicht autorisiert |
Unbekannt
Parameter | |
---|---|
HTTP-Statuscode:400 Bad Request (Ungültige Anfrage) | |
error | unbekannt |
type | https://developers.nest.com/reference/error-messages#unknown |
message | unbekannt |
Unbekannter Anbieter/Gerätetyp
Anbieter/Gerät wurde während der Gerätekopplung nicht erkannt.
Parameter | |
---|---|
HTTP-Statuscode: 400 Bad Request (Ungültige Anfrage) | |
error | Unbekannter Anbieter/Gerätetyp |
type | https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error |
message | Unbekannter 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) | |
error | Der Wert von $fieldName weist den falschen Typ auf |
type | https://developers.nest.com/reference/error-messages#wrong-data-type |
message | Der 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) | |
error | Wo der Name $name bereits vorhanden ist |
type | https://developers.nest.com/reference/error-messages#where-name-exists |
message | Wo 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) | |
error | Wenn kein Name angegeben ist |
type | https://developers.nest.com/reference/error-messages#where-name-missing |
message | Wenn 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) | |
error | Wenn der Name keine Länge hat |
type | https://developers.nest.com/reference/error-messages#zero-length-where-name |
message | Wenn 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) | |
error | Wobei der Name ein String sein muss |
type | https://developers.nest.com/reference/error-messages#where-name-wrong-format |
message | Wobei 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) | |
error | wo ist die ID nicht vorhanden |
type | https://developers.nest.com/reference/error-messages#where-id-invalid |
message | wo 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) | |
error | wo_id muss ein String sein |
type | https://developers.nest.com/reference/error-messages#where-id-wrong-format |
message | wo_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.