Messages d'erreur

Les conditions d'erreur font partie du cycle de développement. Elles peuvent inclure des défaillances simples, telles qu'un paramètre non valide ou manquant, ou des scénarios plus complexes, tels qu'un état inattendu ou même des paramètres liés à l'appareil, qui doivent être résolus en dehors de l'API.

Lorsqu'une erreur se produit lors d'un appel d'API, une réponse au format suivant est envoyée:

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

Tous les messages d'erreur contiennent les champs error, type, message et instance. L'objet details est facultatif.

Champ Description
error Format court du message d'erreur.
type Fournit une URL vers des informations détaillées sur la condition d'erreur (cette page).
message Format de message d'erreur long qui peut utiliser des variables pour fournir des détails supplémentaires. Lorsqu'une variable est incluse dans le message, elle apparaît dans l'objet details.
instance Chaîne de texte qui contient un identifiant d'erreur propre à chaque appel. Nous pouvons vous demander le numéro de l'instance si vous signalez un problème avec le service.
details Facultatif. Contient des variables insérées dans message. Les messages peuvent contenir plusieurs variables.

Pour en savoir plus sur les erreurs sans rapport avec l'API Nest, consultez la section Autres codes et messages d'erreur.

Bloqués

La limite de débit a été dépassée.

Paramètres
HTTP Status Code (Code d'état HTTP) : 429 Too Too Request
errorBloqués
typehttps://developers.nest.com/reference/error-messages#blocked
messageBloqués

Impossible d'activer le ventilateur en cas d'arrêt pour sécurité/fumée

L'arrêt d'urgence est activé. Les appels d'API ne sont acceptés que lorsque le fonctionnement normal est rétabli.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorImpossible d'activer le ventilateur en cas d'arrêt pour sécurité/fumée
typehttps://developers.nest.com/reference/error-messages#safety-shutoff-on
messageImpossible d'activer le ventilateur en cas d'arrêt pour sécurité/fumée

Impossible de changer l'état d'absence lorsque le chauffage d'urgence est allumé

Le produit a essayé de modifier l'état du mode Absent alors que la fonctionnalité Chauffage d'urgence était activée.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorImpossible de changer l'état d'absence lorsque le chauffage d'urgence est allumé
typehttps://developers.nest.com/reference/error-messages#emergency-heat-is-on
messageImpossible de changer l'état d'absence lorsque le chauffage d'urgence est allumé

Impossible de modifier le mode CVC lors d'événements d'économie d'énergie

Un événement d'économie d'énergie défini par un partenaire Nest est en cours. Les appels d'API sont rejetés jusqu'à la fin de l'événement d'économie d'énergie.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorImpossible de modifier le mode CVC lors d'événements d'économie d'énergie
typehttps://developers.nest.com/reference/error-messages#energy-saving-event-on
messageImpossible de modifier le mode CVC lors d'événements d'économie d'énergie

Impossible de modifier le mode CVC

Ce mode n'est pas compatible avec la requête.

par exemple dans les cas suivants:

  • Le système CVC du thermostat n'est pas compatible avec le mode demandé par votre produit: heat, cool, heat-cool ou eco
  • Le mode CVC est défini sur eco et le produit essaie de définir target_temperature
Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorImpossible de définir le mode CVC sur $mode ; le système CVC ne peut pas $action
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
messageImpossible de définir le mode CVC sur $mode ; le système CVC ne peut pas $action
details$mode
$action

Impossible de modifier le mode CVC lorsque le verrouillage du thermostat est activé

L'utilisateur doit déverrouiller le thermostat pour qu'un produit puisse écrire des données.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorImpossible de modifier le mode CVC lorsque le verrouillage du thermostat est activé
typehttps://developers.nest.com/reference/error-messages#lock-enabled
messageImpossible de modifier le mode CVC lorsque le verrouillage du thermostat est activé

Impossible de définir les températures C et F simultanément

Le produit a tenté de régler les températures Celsius et Fahrenheit en même temps. Un produit ne doit définir que la température de consigne spécifiée par la temperature_scale (C/F).

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorImpossible de définir les températures C et F simultanément
typehttps://developers.nest.com/reference/error-messages#multiple-value-changes
messageImpossible de définir les températures C et F simultanément

Impossible d'activer ou de désactiver le paramètre "fan_timer_active" en raison d'un mode incompatible

Le ventilateur du système CVC est déjà utilisé (manuellement ou par programmation, ou en raison d'un cycle chauffage/climatisation).

Si vous n'obtenez pas le résultat attendu, c'est probablement parce que l'appareil dispose d'un comportement intégré que nous ne pouvons pas ignorer via l'API.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorImpossible d'activer ou de désactiver le paramètre "fan_timer_active" en raison de l'incompatibilité du mode $mode
typehttps://developers.nest.com/reference/error-messages#incompatible-fan-mode
messageImpossible d'activer ou de désactiver le paramètre "fan_timer_active" en raison de l'incompatibilité du mode $mode
details$mode

Impossible de définir fan_timer_duration sur la valeur sélectionnée

Le produit a essayé de définir fan_timer_duration sur une valeur non valide. Consultez fan_timer_duration pour obtenir la liste des valeurs valides.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorImpossible de définir fan_timer_duration sur la valeur sélectionnée. Consultez la documentation de référence de l'API pour connaître les valeurs autorisées.
typehttps://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
messageImpossible de définir fan_timer_duration sur la valeur sélectionnée. Consultez la documentation de référence de l'API pour connaître les valeurs autorisées.

Impossible de définir la température minimale de consigne sur une température supérieure à la température de consigne cible

Le thermostat est en mode heat-cool, et le produit a tenté de définir une température cible faible ou élevée en dehors de la plage. Par exemple, le produit a essayé de régler target_temperature_low_c sur 25 °C lorsque target_temperature_high_c est à 24 °C.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorImpossible de définir la température minimale de consigne ($lowTemp) sur une température supérieure à la température de consigne de $highTemp
typehttps://developers.nest.com/reference/error-messages#low-high-error
messageImpossible de définir la température minimale de consigne ($lowTemp) sur une température supérieure à la température de consigne de $highTemp
details$lowTemp
$highTemp

Impossible de définir la température de consigne à moins de N °C

Le produit a tenté de définir une température de consigne trop proche de la température de consigne (par exemple, target_temperature_high_f).

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorImpossible de définir la température de consigne à moins de N °C
typehttps://developers.nest.com/reference/error-messages#range-error
messageImpossible de définir la température de consigne à moins de $min degrés $scale
details$min
$scale

Impossible de définir target_temperature alors que le mode est $mode

Le thermostat ou la structure sont actuellement dans un mode non compatible avec les requêtes API.

Par exemple, vous ne pouvez pas définir target_temperature_f ou target_temperature_c lorsque le système CVC est défini sur off ou en mode heat-cool. Cette valeur ne peut pas être modifiée tant que le thermostat/la structure n'est pas revenu à un mode non restreint.

Dans ce message, $fieldName peut correspondre à l'une des valeurs de température de consigne et la valeur de $mode peut être l'une des valeurs suivantes : eco, emer_heat_enable, heat-cool, heat, cool, off, hvac_safety_shutoff_active.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorImpossible de définir target_temperature si le mode est $mode
typehttps://developers.nest.com/reference/error-messages#mode-error
messageImpossible de définir l'option $fieldName lorsque le mode est défini sur $mode
details$fieldName
$mode

Vous devez mettre à jour le micrologiciel de l'appareil avant de pouvoir changer de mode CVC

Pour définir la température éco, vous devez mettre à jour la version actuelle du micrologiciel sur l'appareil.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorVous devez mettre à jour le micrologiciel de l'appareil avant de pouvoir changer de mode CVC. Les mises à jour sont automatiques, généralement dans un délai d'une semaine.
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
messageVous devez mettre à jour le micrologiciel de l'appareil avant de pouvoir changer de mode CVC. Les mises à jour sont automatiques, généralement dans un délai d'une semaine.

Erreur lors de la validation des champs WWN

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorErreur lors de la validation des champs WWN: $error
typehttps://developers.nest.com/reference/error-messages#where-id-internal
messageErreur lors de la validation des champs WWN: $error
details$error

L'heure d'arrivée prévue est passée

L'heure d'arrivée prévue spécifiée est antérieure à la date du jour. Pour plus d'informations sur les appels ATA, consultez le guide sur l'heure d'arrivée prévue.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorL'heure d'arrivée prévue est passée: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
typehttps://developers.nest.com/reference/error-messages#eta-in-the-past
messageL'heure d'arrivée prévue est passée : $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details$estimatedArrivalTime
$currentTime

L'heure d'arrivée prévue est trop éloignée.

L'heure d'arrivée prévue ne peut pas être postérieure à plus de huit heures. Pour plus d'informations sur les appels ATA, consultez le guide sur l'heure d'arrivée prévue.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorL'heure d'arrivée prévue est trop éloignée.
typehttps://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
messageL'heure d'arrivée prévue est trop éloignée.

fan_timer_active non défini

fan_timer_active non défini.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorfan_timer_active non défini
typehttps://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
messagefan_timer_active non défini

Accès refusé

Les identifiants utilisés pour accéder au service Nest ne sont pas valides.

Paramètres
HTTP Status Code (Code d'état HTTP) : 403 Forbidden (Interdit)
errorAccès refusé
typehttps://developers.nest.com/reference/error-messages#forbidden
messageAccès refusé

Erreur interne

Paramètres
Code d'état HTTP : erreur interne du serveur 500
errorErreur interne
typehttps://developers.nest.com/reference/error-messages#internal-error
messageErreur interne

ID d'appareil photo non valide

camera-id non valide.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorID d'appareil photo non valide : $id
typehttps://developers.nest.com/reference/error-messages#invalid-camera-id
messageID d'appareil photo non valide : $id
details$id

Contenu non valide envoyé

Le contenu de l'appel est incorrect. Utilisez, par exemple, "yes" au lieu de "true" pour une variable booléenne.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorContenu non valide envoyé
typehttps://developers.nest.com/reference/error-messages#invalid-content-sent
messageContenu non valide envoyé

Chemin de fragment non valide

Une partie du chemin de la requête n'est pas valide. Par exemple, un nom d'objet ou de champ peut être mal orthographié.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorChemin de fragment non valide: $requestPath
typehttps://developers.nest.com/reference/error-messages#invalid-fragment
messageChemin de fragment non valide : $requestPath
details$requestPath

Mode CVC incorrect

Le système CVC du thermostat n'est pas compatible avec le mode demandé par le produit : heat, cool ou heat-cool.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorMode CVC incorrect: $mode
typehttps://developers.nest.com/reference/error-messages#invalid-mode
messageMode CVC incorrect: $mode
details$mode

ID de détecteur de fumée et de co incorrect

smoke_co_alarm_id non valide.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorIdentifiant de détecteur de fumée et de co$id incorrect
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
messageID de détecteur de fumée et de co incorrect: $id
details$id

ID de structure non valide

structure_id non valide.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorID de structure $id non valide
typehttps://developers.nest.com/reference/error-messages#invalid-structure-id
messageID de structure non valide: $id
details$id

ID de thermostat non valide

thermostat_id non valide.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorID de thermostat non valide : $id
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
messageID de thermostat non valide: $id
details$id

Valeur incorrecte pour Absent

Vous avez essayé de définir une valeur non valide pour away.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorValeur incorrecte pour Absent
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
messageValeur non valide : $value. Seules les valeurs "home" et "#away" sont autorisées.
details$value

La valeur is_streaming n'est pas booléenne

Le produit a tenté de définir le champ is-streaming sur une valeur non booléenne.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLa valeur is_streaming n'est pas booléenne
typehttps://developers.nest.com/reference/error-messages#invalid-is-stream-format
messageLa valeur is_streaming n'est pas booléenne

Le libellé doit comporter moins de 256 caractères

Le produit a tenté de créer un libellé de thermostat comportant plus de 256 caractères.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLe libellé doit comporter moins de $max_label_length caractères
typehttps://developers.nest.com/reference/error-messages#max-label-length
messageLe libellé doit comporter moins de $max_label_length caractères
details$max_label_length

Nombre maximal personnalisé d'éléments dépassé

Le produit a tenté de créer un objet wheres personnalisé supérieur au maximum. Le nombre maximal d'objets wheres personnalisés autorisés est de 32.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorNombre maximal d'éléments personnalisés où le nombre de $max_where_count est dépassé
typehttps://developers.nest.com/reference/error-messages#max-where-count
messageNombre maximal d'éléments personnalisés où le nombre de $max_where_count est dépassé
details$max_where_count

Nombre maximal personnalisé d'éléments dépassé

L'emplacement où name est trop long. Nous vous recommandons de ne pas dépasser 30 caractères.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLongueur maximale personnalisée (dépasse la longueur du nom ($max_custom_where_name_length))
typehttps://developers.nest.com/reference/error-messages#max-where-name-length
messageLongueur maximale personnalisée (dépasse la longueur du nom ($max_custom_where_name_length))
details$max_custom_where_name_length

Champ manquant

Il manque un paramètre obligatoire dans l'appel.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorChamp non renseigné : $fieldName
typehttps://developers.nest.com/reference/error-messages#field-is-missing
messageChamp non renseigné : $fieldName
details$fieldName

ID du lieu manquant

Le format where_id est manquant.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorID d'emplacement manquant
typehttps://developers.nest.com/reference/error-messages#where-id-missing
messageID d'emplacement manquant

Aucun ventilateur CVC

Le système CVC ne semble pas être équipé d'un ventilateur indépendant.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorAucun ventilateur CVC
typehttps://developers.nest.com/reference/error-messages#no-hvac-fan
messageAucun ventilateur CVC

Aucun thermostat en ligne

Le thermostat est actuellement hors connexion. Une fois le Wi-Fi activé, votre produit devrait pouvoir accéder à nouveau.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorAucun thermostat en ligne
typehttps://developers.nest.com/reference/error-messages#no-thermostats-online
messageAucun thermostat en ligne

Aucun appareil associé

Les appareils Nest de l'utilisateur ne sont pas associés au compte Nest de l'utilisateur.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorAucun appareil associé
typehttps://developers.nest.com/reference/error-messages#no-paired-devices
messageAucun appareil associé

Aucune heure d'arrivée prévue valide

Le trajet n'est pas valide et ne peut pas être annulé.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorAucune heure d'arrivée prévue valide
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageAucune heure d'arrivée prévue valide

Aucune autorisation d'écriture pour les champs

Le client ne dispose pas d'un accès en écriture pour ces données. Pour en savoir plus, consultez la page Présentation des autorisations.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorAucune autorisation d'écriture pour les champs : $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
messageAucune autorisation d'écriture pour les champs : $fields
details$fields

Type de demande non valide

Le type de demande n'est pas valide. Par exemple, un appel POST a été effectué lorsqu'une commande PUT est requise.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorType de demande non valide: $requestType
typehttps://developers.nest.com/reference/error-messages#request-type-not-allowed
messageType de demande non valide: $requestType
details$requestType

Introuvable

L'appel a tenté de lire un chemin qui n'existe pas.

Paramètres
HTTP Status Code:404 Not Found
errorIntrouvable
typehttps://developers.nest.com/reference/error-messages#not-found
messageIntrouvable

Pas en mode Absent

La structure n'est pas en mode Absent lorsqu'un appel ATA est effectué. Les appels ETA ne sont acceptés que lorsque la structure est définie sur "Absent".

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorPas en mode Absent
typehttps://developers.nest.com/reference/error-messages#not-in-away-mode
messagePas en mode Absent

Non accessible en écriture

Le champ auquel vous tentez d'écrire est en lecture seule.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorNon accessible en écriture
typehttps://developers.nest.com/reference/error-messages#not-writable
messageNon accessible en écriture

Uniquement lorsque le nom doit être fourni

Des champs supplémentaires ont été inclus dans l'appel wheres.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorUniquement lorsque le nom doit être fourni
typehttps://developers.nest.com/reference/error-messages#extra-fields
messageUniquement lorsque le nom doit être fourni

POST n'est pas un type de demande valide

Le type de requête n'est pas valide. Par exemple, un appel POST a été effectué lorsqu'une commande PUT est requise.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorPOST n'est pas un type de demande valide
typehttps://developers.nest.com/reference/error-messages#invalid-request-type
messagePOST n'est pas un type de demande valide

Non-respect du schéma

Une erreur s'est produite lors de l'association des appareils.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorNon-respect du schéma
typehttps://developers.nest.com/reference/error-messages#schema-violation-error
messageNon-respect du schéma

Service indisponible

Paramètres
HTTP Status Code (Code d'état HTTP) : 503 Service unavailable
errorService indisponible
typehttps://developers.nest.com/reference/error-messages#service-unavailable
messageService indisponible

Le nombre maximal d'appareils associés est déjà autorisé pour la structure

La structure indique déjà le nombre maximal d'appareils autorisés.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLe nombre maximal d'appareils associés est déjà autorisé pour la structure
typehttps://developers.nest.com/reference/error-messages#max-number-devices-error
messageLe nombre maximal d'appareils associés est déjà autorisé pour la structure

L'utilisateur n'est pas propriétaire de la structure

Le compte structure_id ne correspond pas au compte utilisateur enregistré.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorL'utilisateur n'est pas propriétaire de la structure.
typehttps://developers.nest.com/reference/error-messages#structure-ownership-error-uri
messageL'utilisateur n'est pas propriétaire de la structure.

La température C est trop élevée pour la température de verrouillage

Le thermostat a été verrouillé par l'utilisateur et le produit a tenté de définir une température de consigne en température supérieure à la plage de température de verrouillage.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLa température C de $tempC est trop élevée pour la température de verrouillage $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-c-value-4-lock
messageLa température C de $tempC est trop élevée pour la température de verrouillage $highLockTemp
details$tempC
$highLockTemp

La température C est trop basse pour la température de verrouillage

Le thermostat a été verrouillé par l'utilisateur et le produit a tenté de définir une température de consigne en dessous de la plage de température de verrouillage.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLa température C de $tempC est trop faible pour la température de verrouillage $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-c-value-4-lock
messageLa température C de $tempC est trop faible pour la température de verrouillage $lowLockTemp
details$tempC
$lowLockTemp

La température C est trop élevée

Le produit a tenté de définir une valeur de température de consigne trop élevée pour une température de sel. Pour connaître les plages de températures autorisées en degrés Celsius, consultez la section target_temperature_c.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLa température C est trop élevée: $tempC
typehttps://developers.nest.com/reference/error-messages#high-c-value
messageLa température C est trop élevée : $tempC
details$tempC

La température C est trop basse

Le produit a tenté de définir une valeur de température de consigne trop basse pour une température de sel. Pour connaître les plages de températures autorisées en degrés Celsius, consultez la section target_temperature_c.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLa température C est trop basse : $tempC
typehttps://developers.nest.com/reference/error-messages#low-c-value
messageLa température C est trop basse: $tempC
details$tempC

La température F est trop élevée pour la température de verrouillage

Le thermostat a été verrouillé par l'utilisateur et le produit a tenté de définir une température de consigne en Fahrenheit supérieure à la plage de température de verrouillage.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLa température F ($tempF) est trop élevée pour la température de verrouillage $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-f-value-4-lock
messageLa température F ($tempF) est trop élevée pour la température de verrouillage $highLockTemp
details$tempF
$highLockTemp

La température F est trop basse pour la température de verrouillage

Le thermostat a été verrouillé par l'utilisateur et le produit a tenté de définir une température de consigne en degrés inférieure à la plage de température de verrouillage.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLa température F ($tempF) est trop faible pour la température de verrouillage $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-f-value-4-lock
messageLa température F ($tempF) est trop faible pour la température de verrouillage $lowLockTemp
details$tempF
$lowLockTemp

La température F est trop élevée

Le produit a tenté de définir une valeur de température de consigne trop élevée pour une température en Fahrenheit. Pour connaître les plages de températures autorisées en Fahrenheit, consultez target_temperature_f.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLa température F est trop élevée : $tempF
typehttps://developers.nest.com/reference/error-messages#high-f-value
messageLa température F est trop élevée: $tempF
details$tempF

La température F est trop faible

Le produit a tenté de définir une valeur de température de consigne trop basse pour une température en Fahrenheit. Pour connaître les plages de températures autorisées en Fahrenheit, consultez target_temperature_f.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLa valeur F de la température est trop basse : $tempF
typehttps://developers.nest.com/reference/error-messages#low-f-value
messageLa valeur F de la température est trop basse: $tempF
details$tempF

Le format de la température est incorrect

Le produit a tenté de définir une température de consigne dans un format numérique incorrect pour l'élément temperature_scale choisi. Les températures Celsius doivent être des nombres entiers par incréments de 0,5 degré (21,5) et les températures Fahrenheit par des nombres entiers (72).

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLe format de la température $temp est incorrect
typehttps://developers.nest.com/reference/error-messages#format-error
messageLe format de la température $temp est incorrect
details$temp

Les champs ne peuvent pas être modifiés lors de la mise à jour.

Le produit a tenté d'écrire dans un champ en lecture seule.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLes champs suivants ne peuvent pas être modifiés : $fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
messageLes champs suivants ne peuvent pas être modifiés: $fieldNames
details$fieldNames

Les champs doivent être au format ISO 8601.

Le champ n'est pas au format ISO 8601.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLes champs doivent être au format ISO 8601: $fieldNames
typehttps://developers.nest.com/reference/error-messages#time-format-error
messageLes champs doivent être au format ISO 8601: $fieldNames
details$fieldNames

Le thermostat n'est pas en ligne

Le thermostat est actuellement hors connexion. Une fois le Wi-Fi activé, votre produit devrait pouvoir accéder à nouveau.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLe thermostat n'est pas en ligne
typehttps://developers.nest.com/reference/error-messages#not-online
messageLe thermostat n'est pas en ligne

Ce trajet a été remplacé manuellement

L'utilisateur a ignoré le trajet manuellement.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorCe trajet a été remplacé manuellement
typehttps://developers.nest.com/reference/error-messages#trip-manually-overidden
messageCe trajet a été remplacé manuellement

Impossible de créer un ID

L'objet wheres est manquant. Aucune valeur where_id n'est définie.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorImpossible de créer un ID de zone géographique
typehttps://developers.nest.com/reference/error-messages#wheres-missing
messageImpossible de créer un ID de zone géographique

Non autorisé

Échec de l'autorisation.

Deux conditions peuvent générer le message d'erreur suivant:

  • redirections incorrectes qui se produisent lorsqu'une implémentation HTTP donnée ne transfère pas automatiquement l'en-tête Authorization à l'URI redirigé. Pour en savoir plus, consultez Gérer les redirections.

  • autorisations incorrectes lors de la tentative d'accès aux points de terminaison de l'API. Par exemple, si vous essayez de lire un point de terminaison de thermostat lorsque seules les autorisations de la caméra sont sélectionnées pour le client, Pour en savoir plus, consultez Choisir les autorisations.

Paramètres
HTTP Status Code : 401 Unauthorized
errorNon autorisé
typehttps://developers.nest.com/reference/error-messages#auth-error
messageNon autorisé

Inconnu

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorinconnu
typehttps://developers.nest.com/reference/error-messages#unknown
messageinconnu

Fournisseur/Type d'appareil inconnu

Fournisseur/appareil non reconnu lors de l'association de l'appareil.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorFournisseur/Type d'appareil inconnu
typehttps://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
messageFournisseur/Type d'appareil inconnu

La valeur de $fieldName est incorrecte

Le mauvais type de données a été envoyé. Par exemple, envoyez une chaîne lorsqu'une valeur booléenne est attendue.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorLe type de valeur de $fieldName est incorrect.
typehttps://developers.nest.com/reference/error-messages#wrong-data-type
messageLe type de valeur de $fieldName est incorrect.
details$fieldName

Où le nom existe déjà

Le where_name que le produit a essayé de définir existe déjà. Réessayez avec un autre nom.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorOù le nom $name existe déjà
typehttps://developers.nest.com/reference/error-messages#where-name-exists
messageOù le nom $name existe déjà
details$name

Où le nom n'est pas indiqué.

where_name manquant dans l'appel.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorOù le nom n'est pas indiqué.
typehttps://developers.nest.com/reference/error-messages#where-name-missing
messageOù le nom n'est pas indiqué.

Où le nom n'a aucune longueur

name n'est pas défini (ne comporte aucun caractère).

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorOù le nom n'a aucune longueur
typehttps://developers.nest.com/reference/error-messages#zero-length-where-name
messageOù le nom n'a aucune longueur

Où le nom doit être une chaîne

Le type de données envoyé pour where_name est incorrect. Par exemple, un nombre lorsqu'une chaîne est attendue.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorOù le nom doit être une chaîne
typehttps://developers.nest.com/reference/error-messages#where-name-wrong-format
messageOù le nom doit être une chaîne

Où "id_id" n'existe pas

where_id non valide.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
errorOù "id_id" n'existe pas
typehttps://developers.nest.com/reference/error-messages#where-id-invalid
messageOù "id_id" n'existe pas
details$where_id

où "id_id" doit être une chaîne

Le format where_id n'est pas valide. Par exemple, un nombre a été envoyé à la place d'une chaîne.

Paramètres
HTTP Status Code (Code d'état HTTP) : 400 Bad Request (Requête incorrecte)
erroroù "id_id" doit être une chaîne
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messageoù "id_id" doit être une chaîne

Autres codes et messages d'erreur

Codes d'erreur des appareils

Pour obtenir des codes d'erreur et des messages spécifiques à chaque appareil qui ne sont pas liés à l'API Nest, consultez les articles suivants:

Codes d'erreur REST

Lorsque vous effectuez un appel d'API REST, les codes d'état HTTP courants sont renvoyés.

Messages sur la limitation du débit REST

Lorsque vous utilisez REST et que vous envoyez trop d'appels en peu de temps, vous pouvez recevoir un code d'état de réponse HTTP de 429 requêtes trop.

Pour en savoir plus, consultez l'article Limites de débit des données.