Cette page répertorie les messages d’erreur et les codes que les utilisateurs et les intégrations rencontrent le plus souvent, regroupés selon l’endroit où ils apparaissent, avec leur signification et la solution. Les messages sont cités tels que Hermetry les affiche. Les codes en police de code sont stables et peuvent être utilisés sans risque dans votre propre gestion des erreurs ; les phrases peuvent changer. Pour une erreur non listée ici, recherchez dans la section de la fonctionnalité, ou consultez Obtenir de l’aide.
Limites du forfait
Une limite du forfait renvoie 403 avec details.key désignant la limite, details.limit sa valeur et details.current votre nombre actuel.
details.key ou message | Limite | Solution |
|---|---|---|
max_devices, « La limite d’appareils de ce compte est atteinte. » | Appareils (43, 77 ou 403 selon le palier) | Supprimez les appareils inutilisés (appareils d’exemple, appareils en quarantaine) ou changez de forfait |
| « Votre forfait autorise n flux : m utilisés, et ce déploiement en ajoute k. » | Flux ou blocs de script | Supprimez ou fusionnez des flux ; voir Limites des flux |
| « Votre forfait autorise {limit} caméras avec visualisation en direct, et {current} sur {limit} sont utilisées. » | Caméras avec visualisation en direct (12) | Désactivez la visualisation en direct sur une caméra que vous ne regardez pas |
| Minutes caméra épuisées | Minutes caméra mensuelles (10 000) | Attendez le mois suivant, ou un pack d’utilisation |
| « Le quota mensuel de données du panneau est épuisé. » | Données du panneau du routeur (10 GiB par mois) | Attendez le mois suivant |
key_limit (dans l’exécution d’un flux) | Clés de télémétrie (250, 400 ou 2 050) | Supprimez les clés inutiles avant d’Enregistrer la télémétrie |
FEATURE_NOT_AVAILABLE | Votre forfait n’inclut pas cette fonctionnalité | Voir Mes modules |
Le quota mensuel de messages IoT ne produit jamais d’erreur : les appareils continuent d’envoyer au-delà. Voir Limites et quotas.
API REST
Statut et code | Signification | Solution |
|---|---|---|
400 VALIDATION_ERROR, « Erreur de validation » avec issues | Un champ enfreint une règle | Lisez issues[].path et message |
400 « Corps de requête mal formé » | Le corps n’est pas du JSON valide | Corrigez le JSON |
401 UNAUTHORIZED, « Clé d’API invalide ou expirée. » | Une faute de frappe, une clé expirée ou révoquée, ou la clé d’une autre organisation | Vérifiez la clé et le tenantId dans le chemin |
403 « La clé d’API n’a pas la permission requise. » | La clé ne possède pas la permission de la route | Modifiez les Permissions du module de la clé |
403 « Vous n’êtes pas autorisé à effectuer cette action » | Le titulaire de la clé n’a plus la permission | Vérifiez le rôle, les groupes et les politiques d’accès du titulaire |
403 « Cette clé d’API ne peut pas être utilisée depuis l’adresse IP actuelle. » | La liste d’adresses IP autorisées de la clé ou de l’organisation | Appelez depuis un réseau autorisé |
403 TENANT_IP_NOT_ALLOWED | Les listes d’accès IP de l’organisation refusent l’adresse | Utilisez un réseau autorisé |
403 TENANT_SUSPENDED, TENANT_INACTIVE | L’organisation n’est pas active | Demandez à un propriétaire |
404 NOT_FOUND | Introuvable, ou non visible pour vous | Vérifiez l’identifiant et les permissions |
409 CONFLICT | Un doublon, un enregistrement en cours d’utilisation, un état qui interdit l’action, ou une modification concurrente | Relisez, puis décidez |
412, 428 | If-Match est périmé ou absent | Relisez et renvoyez avec la nouvelle version |
413 | Corps ou fichier trop volumineux | Envoyez moins |
429 RATE_LIMIT_EXCEEDED, « Trop de requêtes. Veuillez réessayer plus tard. » | La limite par adresse (120 par minute) | Attendez Retry-After |
429 « Limite de débit de la clé d’API dépassée. Veuillez ralentir. » | La limite par clé (1 000 par minute par défaut) | Répartissez les appels |
429 « La limite de débit d’API de votre forfait a été atteinte… » | La limite du forfait de l’organisation | Répartissez les appels ou changez de forfait |
503 TENANT_READ_ONLY, « Cet espace de travail est en lecture seule pendant son déplacement. Veuillez réessayer plus tard. » | L’organisation est en cours de déplacement | Réessayez après Retry-After (300 s) ; les lectures fonctionnent |
Voir Erreurs et limites de débit.
Connexions et messages des appareils
| Code | Signification | Solution |
|---|---|---|
| CONNACK 1 | Version MQTT non prise en charge | Utilisez MQTT 3.1.1 |
| CONNACK 2 | Identifiant client refusé | 1 à 64 caractères parmi A–Z a–z 0–9 . _ : - |
| CONNACK 3 | Serveur indisponible, ou adresse bloquée brièvement après des connexions échouées | Attendez avec un délai aléatoire ; corrigez l’appareil aux identifiants erronés |
| CONNACK 4 | Nom d’utilisateur ou mot de passe incorrect | Vérifiez ou renouvelez l’identifiant |
| CONNACK 5 | Non autorisé ; la raison se trouve dans l’onglet Journal de l’appareil | Voir Un appareil ne se connecte pas |
unknown_reserved_topic | Publié sur un topic inconnu sous v1/ | Utilisez un topic documenté |
forbidden_topic | Un topic de downlink, un topic de passerelle depuis un appareil qui n’est pas une passerelle, ou un provisionnement hors session de provisionnement | Utilisez le bon topic pour l’appareil |
tls_required (HTTP 403) | Une interrogation de commandes en HTTP simple que le profil n’autorise pas | Utilisez HTTPS |
child_limit, device_limit | Un enfant de passerelle au-delà de la limite d’enfants de la passerelle ou de la limite d’appareils du forfait | Augmentez le Nombre max d’enfants d’une passerelle du profil, ou libérez des appareils |
child_rate_limited | Un enfant de passerelle au-delà de ses propres limites de débit | Réduisez le débit de l’enfant |
Données stockées
| Code | Signification |
|---|---|
key_invalid, key_too_long, key_reserved | La clé enfreint une règle de clé : caractères, 64 caractères, ou préfixe réservé (_, fw_, current_fw_, cfg.) |
string_too_long, value_too_large | Texte de plus de 1 024 caractères ; JSON de plus de 4 KiB ; un nombre qui n’est pas fini |
bad_form | Forme que le stockage ne lit pas, ou plus de 1 000 points dans un message |
bad_ts | Un horodatage qui n’est pas en millisecondes epoch, trop loin dans le futur (10 minutes par défaut) ou plus ancien que ne le permettent les paramètres |
too_old | Plus ancien que ce que votre classe de rétention conserve en données brutes |
no_values | Rien dans l’enregistrement n’a pu être stocké |
not_a_device | Un Enregistrer la télémétrie dans un flux démarré par un planning, un inject, un événement ou un webhook, qui ne concerne pas un appareil |
range_too_large (API d’historique, 400) | Plus de 10 000 buckets dans la fenêtre |
Voir Les données n’arrivent pas.
Commandes
| Motif | Signification |
|---|---|
bad_params | Les paramètres ne correspondent pas à la commande |
wait_too_long | Un appel synchrone attend 30 s au maximum ; utilisez wait: false |
confirm_required, confirm_text_mismatch | Une commande à fort impact nécessite confirm: true, ou le texte saisi est erroné |
method_refused | La réinitialisation d’usine, l’appairage, l’oubli du Wi-Fi et l’oubli du cloud ne sont jamais envoyés |
rpc_method_reserved | La méthode appartient à un autre module |
rpc_not_supported_by_profile | Le profil n’utilise que les topics Legacy |
device_not_active | L’appareil est désactivé ou en quarantaine |
not_cancellable | Seule une commande en file ou envoyée peut être annulée |
device_rate_limited, « Trop de commandes pour cet appareil ; réessayez dans une minute. » | Plus de 10 commandes par minute vers un même appareil |
Voir Les commandes n’atteignent pas l’appareil.
Flux
| Code ou message | Signification |
|---|---|
circuit_open | Les appels sortants d’un bloc échouent sans cesse et sont suspendus ; il se rétablit seul |
ssrf_blocked | L’adresse est privée, absente des hôtes autorisés du point de terminaison, ou sort du chemin de base |
timeout, memory, blocked (script) | Le script a dépassé son temps CPU (50 ms par défaut) ou 32 MiB ; après trois arrêts d’affilée, il est bloqué pendant 60 secondes |
script_unavailable, host_busy | Le service de script est injoignable ou occupé ; réessayez plus tard |
queue_full | Un bloc contient trop de messages ou de clés |
flow_cycle | Des flux se déclenchent mutuellement en boucle |
| « Ces blocs envoient des messages en boucle qui n’attend jamais » | Un cycle sans bloc d’attente dans un même flux |
no_recipients, too_many_recipients, members_unavailable, invalid_attachment, notify_failed, limit | Erreurs de Notify : personne à prévenir, plus de 20 destinataires après résolution des rôles, impossibilité de lire les membres, pièce jointe non valide, échec de toutes les livraisons, quota épuisé sur tous les canaux |
Voir Dépannage des flux.
Alarmes et règles
| Message | Correction |
|---|---|
| « Une clé désigne une clé de télémesure : sans espaces et non numérique. » | Saisissez la valeur dans Value, et non dans Key |
| « Une autre règle de ce profil a ce type. » | Utilisez un type unique par profil |
| « Entre 10 secondes et 7 jours. » | Le délai de hors ligne est hors plage |
| « Une mise en sourdine peut durer 90 jours au maximum. » | Choisissez une fin plus proche |
| « Le lever et le coucher du soleil nécessitent la position du site : définissez-la d’abord sur le site. » | Renseignez la latitude et la longitude de l’actif |
| « 20 actions au maximum, y compris celles contenues dans les choix. » | Scindez la règle de la carte Rules |
| « Ce type d’appareil ne dispose pas de cette commande. » | Ajoutez la commande au catalogue du profil |
Profils, actifs et tableaux
| Message | Correction |
|---|---|
| « Encore utilisé par … : déplacez-les ou supprimez-les d’abord. » | Un profil encore utilisé par des appareils, des règles d’alarme ou des commandes ne peut pas être supprimé |
| « désignez d’abord un autre profil par défaut » | Le profil par défaut ne peut pas être supprimé |
| « Un actif ayant des actifs enfants ne peut pas être supprimé. » | Supprimez ou déplacez d’abord les enfants |
| « Ce fichier n’est pas un paquet de tableau de bord reconnu par cette version. » | Importez un fichier de tableau exporté depuis un tableau de bord |
| « Rien dans ce paquet ne peut être importé ici. » | Installez d’abord les modules ou widgets nécessaires au tableau |
Connexion
| Message | Correction |
|---|---|
| « Ce compte est verrouillé après trop de tentatives de connexion échouées. Réessayez plus tard ou réinitialisez votre mot de passe. » | Patientez ou réinitialisez le mot de passe |
| « Trop de codes erronés. Veuillez patienter quelques minutes et réessayer. » | Patienter |
| « Cette organisation exige une vérification en deux étapes. Reconnectez-vous et effectuez-la. » | Ajoutez une clé d’accès (passkey) et connectez-vous avec elle |
| « Ce compte est verrouillé pour des raisons de sécurité… » | Contactez le support |
Voir Problèmes de connexion.
Caméras et panneaux de routeur
| Message ou code | Correction |
|---|---|
| « L’image a été demandée trop souvent. Patientez un instant et réessayez. » | Plus de 24 demandes de lien en direct par minute pour une même caméra |
| « Trop de caméras sont consultées sur cette installation en ce moment. Réessayez dans un instant. » | La capacité de l’installation ; réessayez |
ttl_idle, ttl_hard, lte_cap, no_dial … (Ended because de la session du panneau) | Voir Limites et audit de l’accès à distance |