Documentation de référence sur le code d'erreur de l'API

L'API Smart Device Management utilise des codes d'erreur gRPC standards. Pour en savoir plus sur ces codes, consultez la section Traitement des erreurs.

Une réponse d'erreur dans l'API s'affiche au format suivant :

{
  "error": {
    "code": 404,
    "message": "Device enterprises/project-id/devices/device-id not found.",
    "status": "NOT_FOUND"
  }
}

Utilisez le champ de recherche du tableau Codes d'erreur pour trouver les erreurs d'API, ainsi que des conseils de dépannage, des caractéristiques et des guides associés. Vous pouvez rechercher du contenu dans n'importe quel champ du tableau.

Message d'erreur HTTP RPC Dépannage
L'image de la caméra n'est plus disponible au téléchargement. 504 DEADLINE_EXCEEDED Les images d'événement expirent 30 secondes après la publication de l'événement. Veillez à télécharger l'image avant son expiration.

Voir aussi :
  Tâche Télécharger une image de caméra
  Appareil d'affichage
  Sonnette
  Guide des événements
  GenerateImage
  Caractéristique CameraMotion
  Caractéristique CameraPerson
  Caractéristique CameraSound
  Caractéristique DoorbellChime
La commande n'est pas compatible avec la sonnette. 400 FAILED_PRECONDITION Un flux WebRTC ne peut pas être étendu sur les sonnettes alimentées par batterie. Si un flux sur une sonnette doit être visionné au-delà de la durée de session initiale, arrêtez le flux existant et générez-en un nouveau.

Voir aussi :
  Étendre une diffusion en direct tâche
  ExtendWebRtcStream commande
La commande n'est pas autorisée dans le mode de thermostat actuel. 400 FAILED_PRECONDITION Certains modèles de thermostats ne permettent pas de modifier le mode Éco lorsque le mode du thermostat est désactivé, conformément à la caractéristique ThermostatMode Le mode du thermostat doit être défini sur CHAUFFAGE, CLIMATISATION ou CHAUFFAGECLIMATISATION avant de pouvoir modifier le mode Éco.

Voir aussi :
  Tâche Modifier le mode
  SetMode
  Caractéristique ThermostatMode
  Caractéristique ThermostatTemperatureSetpoint
La commande n'est pas autorisée lorsque le thermostat est en mode ÉCO_MANUEL. 400 FAILED_PRECONDITION La température de consigne ne peut pas être définie lorsque le thermostat est en mode Éco manuel.

Voir aussi :
  Tâche Modifier les températures de consigne
  Caractéristique ThermostatEco
  Caractéristique ThermostatTemperatureSetpoint
La commande n'a pas été fournie. 404 NOT_FOUND Une commande a été exécutée sans nom de commande valide dans le corps de la requête. Saisissez une commande valide.
La commande n'est pas compatible. 400 INVALID_ARGUMENT Vous avez utilisé une commande de diffusion en direct RTSP pour une caméra compatible avec WebRTC, ou vous avez utilisé une commande de diffusion en direct WebRTC pour une caméra compatible avec RTSP.

Voir aussi :
  Tâche Télécharger une image de caméra
Contient une valeur non valide. 400 INVALID_ARGUMENT Une commande a été envoyée avec une valeur non valide dans les arguments. Veillez à envoyer une valeur valide.
La valeur de refroidissement doit être supérieure à la valeur de chauffage. 400 INVALID_ARGUMENT Assurez-vous que le heatCelsius champ est inférieur au coolCelsius champ dans votre commande.

Voir aussi :
  Tâche Modifier les températures de consigne
  Caractéristique ThermostatTemperatureSetpoint
Appareil introuvable. 404 NOT_FOUND Un nom d'appareil non valide ou manquant a été spécifié. Spécifiez un appareil valide.

Voir aussi :
  Caractéristique Connectivity
Entreprise introuvable. 404 NOT_FOUND Un ID non valide ou manquant Project a été spécifié. Spécifiez un ID valide Project .
L'ID d'événement n'appartient pas à la caméra. 400 FAILED_PRECONDITION Utilisez le eventID correct renvoyé par l'événement de la caméra.

Voir aussi :
  Gérer les événements de la caméra tâche
  Affichage appareil
  Gérer les événements de la sonnette et de la caméra tâche
  Événements guide
  CameraEventImage caractéristique
  CameraMotion caractéristique
  CameraPerson caractéristique
  CameraSound caractéristique
  DoorbellChime caractéristique
Échec de la récupération du SDP de réponse en raison d'un délai d'attente dépassé. 504 DEADLINE_EXCEEDED Essayez de générer à nouveau la diffusion en direct WebRTC.

Voir aussi :
Le champ n'est pas présent dans les caractéristiques. 400 INVALID_ARGUMENT Une commande non compatible a été envoyée pour une caractéristique.
Le SDP d'offre non valide ne contient pas de CRLF. 400 INVALID_ARGUMENT Le caractère de retour à la ligne est manquant à la fin de la chaîne offerSdp lors de la tentative de génération d'un flux WebRTC. Assurez-vous que la chaîne offerSdp se termine par \r\n ou \n, puis essayez de générer à nouveau le flux.

Voir aussi :
Lignes m du SDP d'offre non valides. 400 INVALID_ARGUMENT Le SDP d'offre doit contenir les trois lignes m audio, vidéo et application dans cet ordre.

Voir aussi :
SDP d'offre non valide. 400 INVALID_ARGUMENT L'audio du SDP d'offre doit être défini sur a=recvonly (réception uniquement).

Voir aussi :
Autorisation refusée. 403 PERMISSION_DENIED Le user n'a pas accordé les developer autorisations au niveau de l'appareil appropriées dans le Gestionnaire des connexions partenaires (PCM) requises pour exécuter une commande.

Lors de la génération d'une diffusion en direct WebRTC, cette erreur peut également signifier que le paramètre audio dans le offerSdp est incorrect.

Voir aussi :
  Tâche Associer votre compte
  GenerateWebRtcStream
Nombre limité. 429 RESOURCE_EXHAUSTED Chaque développeur dispose d'un quota limitant le nombre d'appels qu'il peut effectuer. Si vous effectuez plus d'appels que votre quota, le message "Nombre limité" s'affiche. Pour résoudre ce problème, renvoyez l'appel une fois le quota expiré.

Voir aussi :
  Concept de limites de débit du bac à sable
Salle introuvable. 404 NOT_FOUND La salle n'existe pas dans la structure. Effectuez un appel de liste à la ressource des salles pour vérifier l'ID de la salle.
Structure introuvable. 404 NOT_FOUND La structure n'existe pas dans le Project. Effectuez un appel de liste à la ressource de la structure pour vérifier l'ID de la structure.
La caméra n'est pas disponible pour la diffusion. 400 FAILED_PRECONDITION La caméra est hors connexion ou n'est pas disponible pour la diffusion en raison d'un problème technique.

Voir aussi :
  Appareil photo
  Appareil photo (batterie)
  Appareil photo (filaire)
  Sonnette (batterie)
  Sonnette (filaire)
  GenerateWebRtcStream
Ventilateur du thermostat indisponible. 400 FAILED_PRECONDITION Le thermostat ne dispose pas d'une fonctionnalité de ventilateur. Les caractéristiques et commandes liées au ventilateur ne peuvent pas être utilisées pour cet appareil.

Voir aussi :
  Tâche Activer ou désactiver le ventilateur
  Caractéristique Fan