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 code font 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 nommant la limite, details.limit sa valeur et details.current votre nombre.
details.key ou message | Limite | Solution |
|---|---|---|
max_devices, « La limite d’appareils de ce compte est atteinte. » | Appareils (43, 77 ou 403 selon le niveau) | Supprimer les appareils inutilisés (appareils d’exemple, appareils en quarantaine) ou changer de forfait |
| « Votre forfait autorise n flux : m utilisés, et ce déploiement en ajoute k. » | Flux ou blocs de script | Supprimer ou fusionner des flux ; voir Limites des flux |
| « Votre forfait autorise 12 caméras avec visualisation en direct, et 12 sur 12 sont utilisées. » | Caméras avec visualisation en direct (12) | Désactiver la visualisation en direct sur une caméra que vous ne regardez pas |
| Minutes caméra épuisées | Minutes caméra mensuelles (10 000) | Attendre le mois suivant, ou un pack de minutes supplémentaires |
| « Le quota mensuel de données du panneau est épuisé. » | Données du panneau du routeur (10 GiB par mois) | Attendre le mois suivant |
key_limit (dans l’exécution d’un flux) | Clés de télémétrie (250, 400 ou 2 050) | Supprimer les clés inutiles avant Enregistrer la télémétrie |
FEATURE_NOT_AVAILABLE | Votre forfait ne comprend 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, « Validation error » avec issues | Un champ ne respecte pas une règle | Lire issues[].path et message |
400 « Corps de requête mal formé » | Le corps n’est pas du JSON valide | Corriger le JSON |
401 UNAUTHORIZED, « Clé 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érifier la clé et le tenantId dans le chemin |
403 « La clé API ne dispose pas de l’autorisation requise. » | La clé ne possède pas la permission de la route | Modifier 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érifier 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 | Appeler depuis un réseau autorisé |
403 TENANT_IP_NOT_ALLOWED | Les listes d’accès IP de l’organisation refusent l’adresse | Utiliser un réseau autorisé |
403 TENANT_SUSPENDED, TENANT_INACTIVE | L’organisation n’est pas active | Demander à un propriétaire |
404 NOT_FOUND | Introuvable, ou non visible pour vous | Vérifier 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 | Relire, puis décider |
412, 428 | If-Match est périmé ou absent | Relire puis renvoyer avec la nouvelle version |
413 | Corps ou fichier trop volumineux | Envoyer moins |
429 RATE_LIMIT_EXCEEDED, « Trop de requêtes. Veuillez réessayer plus tard. » | La limite par adresse (120 par minute) | Attendre Retry-After |
429 « Limite de débit de la clé API dépassée. Veuillez ralentir. » | La limite par clé (1 000 par minute par défaut) | Étaler les appels |
429 « La limite de débit de l’API de votre offre a été atteinte… » | La limite de forfait de l’organisation | Étaler les appels ou changer 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 migration | Réessayer 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 | Utiliser MQTT 3.1.1 |
| CONNACK 2 | Identifiant client refusé | De 1 à 64 caractères parmi A–Z a–z 0–9 . _ : - |
| CONNACK 3 | Serveur indisponible, ou adresse brièvement bloquée après des connexions échouées | Attendre avec un délai aléatoire ; corriger l’appareil aux identifiants erronés |
| CONNACK 4 | Nom d’utilisateur ou mot de passe incorrect | Vérifier ou renouveler l’identifiant |
| CONNACK 5 | Non autorisé ; la raison figure dans l’onglet Journal de l’appareil | Voir Un appareil ne se connecte pas |
unknown_reserved_topic | Publication sur un topic inconnu sous v1/ | Utiliser un topic documenté |
forbidden_topic | Un topic de liaison descendante, un topic de passerelle depuis un appareil qui n’en est pas une, ou un provisionnement hors session de provisionnement | Utiliser le bon topic pour l’appareil |
tls_required (HTTP 403) | Une interrogation de commandes en HTTP simple que le profil n’autorise pas | Utiliser HTTPS |
child_limit, device_limit | Un appareil enfant de passerelle au-delà de la limite d’enfants de la passerelle ou de la limite d’appareils du forfait | Augmenter Nombre max d’enfants d’une passerelle du profil, ou libérer des appareils |
child_rate_limited | Un appareil enfant de passerelle au-delà de ses propres limites de débit | Réduire 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 un 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 ; nombre non fini |
bad_form | Forme que le stockage ne lit pas, ou plus de 1 000 points dans un message |
bad_ts | Horodatage non exprimé en millisecondes depuis l’époque, trop éloigné dans le futur (10 minutes par défaut) ou plus ancien que les réglages ne le permettent |
too_old | Plus ancien que la durée de conservation de votre classe de rétention pour les 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 une planification, une injection, un événement ou un webhook, qui ne concerne pas un appareil |
range_too_large (API d’historique, 400) | Plus de 10 000 intervalles dans la fenêtre |
Voir Les données n’arrivent pas.
Commandes
| Raison | Signification |
|---|---|
bad_params | Les paramètres ne correspondent pas à la commande |
wait_too_long | Un appel synchrone attend au maximum 30 s ; utiliser wait: false |
confirm_required, confirm_text_mismatch | Une commande à fort impact exige 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 d’attente ou envoyée peut être annulée |
device_rate_limited, « Trop de commandes envoyées à 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 continuent d’échouer et sont suspendus ; il se rétablit de lui-même |
ssrf_blocked | L’adresse est privée, ne figure pas parmi les 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éessayer plus tard |
queue_full | Un bloc retient trop de messages ou de clés |
flow_cycle | Des flux se déclenchent mutuellement en boucle |
| « Ces blocs envoient des messages en boucle sans jamais attendre » | 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 : aucun destinataire à prévenir, plus de 20 destinataires après application des rôles, membres impossibles à lire, pièce jointe invalide, toutes les livraisons ont échoué, tous les canaux ont épuisé leur quota |
Voir Dépannage des flux.
Alarmes et règles
| Message | Correctif |
|---|---|
| « Une clé désigne une clé de télémétrie : pas d’espaces et pas un nombre. » | Saisissez la valeur dans Value, et non dans Key |
| « Une autre règle de ce profil a déjà ce type. » | Utilisez un type unique par profil |
| « Entre 10 secondes et 7 jours. » | Le délai avant 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 lieu : renseignez-la d’abord sur le lieu. » | Renseignez la latitude et la longitude sur 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 possède pas une telle commande. » | Ajoutez la commande au catalogue du profil |
Profils, actifs et cartes
| Message | Correctif |
|---|---|
| « 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éfinissez d’abord un autre profil par défaut. » | Le profil par défaut ne peut pas être supprimé |
| « Un actif contenant des actifs enfants ne peut pas être supprimé. » | Supprimez ou déplacez d’abord les enfants |
| « Ce fichier n’est pas un package de tableau de bord que cette version comprend. » | Importez un fichier de carte exporté depuis un tableau de bord |
| « Rien dans ce package ne peut être importé ici. » | Installez d’abord les modules ou widgets nécessaires à la carte |
Connexion
| Message | Correctif |
|---|---|
| « Ce compte est verrouillé après trop de tentatives de connexion échouées. Réessayez plus tard ou réinitialisez votre mot de passe. » | Attendez ou réinitialisez le mot de passe |
| « Trop de codes erronés. Veuillez patienter quelques minutes et réessayer. » | Patientez |
| « Cette organisation exige une vérification en deux étapes. Reconnectez-vous et effectuez-la. » | Ajoutez une clé d’accès 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 | Correctif |
|---|---|
| « L’image a été demandée trop souvent. Patientez un moment 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 |

