Mensajes de error

Esta página recoge los mensajes de error y los códigos con los que más se encuentran las personas y las integraciones, agrupados según dónde aparecen, con su significado y la solución. Los mensajes se citan tal como los muestra Hermetry. Los códigos en fuente de código son estables y seguros para usarlos en su propio manejo de errores; las frases pueden cambiar. Para un error que no aparezca aquí, busque en la sección de la función o consulte Obtener ayuda.

Límites del plan

Un límite del plan responde 403 con details.key que indica el límite, details.limit su valor y details.current su recuento.

`details.key` o mensaje	Límite	Solución
`max_devices`, «Se ha alcanzado el límite de dispositivos de esta cuenta.»	Dispositivos (43, 77 o 403 según el nivel)	Elimine los dispositivos que no use (dispositivos de muestra, en cuarentena) o cambie el plan
«Su plan permite n flujos: m en uso, y este despliegue añade k.»	Flujos o bloques de script	Elimine o combine flujos; consulte Límites de flujos
«Su plan permite {limit} cámaras con vista en directo, y {current} de {limit} están en uso.»	Cámaras con vista en directo (12)	Desactive la vista en directo de una cámara que no vigila
Minutos de cámara agotados	Minutos de cámara al mes (10.000)	Espere al mes siguiente o use un paquete de uso
«Se ha agotado la cuota de datos del panel de este mes.»	Datos del panel del router (10 GiB al mes)	Espere al mes siguiente
`key_limit` (en la ejecución de un flujo)	Claves de telemetría (250, 400 o 2.050)	Elimine las claves que no necesite antes de Guardar telemetría
`FEATURE_NOT_AVAILABLE`	Su plan no incluye la función	Consulte Mis módulos

La cuota mensual de mensajes IoT nunca produce un error: los dispositivos siguen enviando más allá de ella. Consulte Límites y cuotas.

API REST

Estado y `code`	Significado	Solución
`400` `VALIDATION_ERROR`, «Error de validación» con `issues`	Un campo incumple una regla	Lea `issues[].path` y `message`
`400` «Cuerpo de la solicitud mal formado»	El cuerpo no es JSON válido	Corrija el JSON
`401` `UNAUTHORIZED`, «Clave de API no válida o caducada.»	Una errata, una clave caducada o revocada, o la clave de otra organización	Compruebe la clave y el `tenantId` de la ruta
`403` «La clave de API no tiene el permiso necesario.»	La clave no tiene el permiso de la ruta	Edite los Permisos de módulo de la clave
`403` «No tiene permiso para realizar esta acción»	El titular de la clave ya no tiene el permiso	Revise el rol, los grupos y las políticas de acceso del titular
`403` «Esta clave de API no puede usarse desde la dirección IP actual.»	La lista de IP permitidas de la clave o de la organización	Llame desde una red permitida
`403` `TENANT_IP_NOT_ALLOWED`	Las listas de acceso por IP de la organización rechazan la dirección	Use una red permitida
`403` `TENANT_SUSPENDED`, `TENANT_INACTIVE`	La organización no está activa	Consulte con un propietario
`404` `NOT_FOUND`	No encontrado, o no visible para usted	Compruebe el id y los permisos
`409` `CONFLICT`	Un duplicado, un registro en uso, un estado que impide la acción, o un cambio concurrente	Vuelva a leer y luego decida
`412`, `428`	`If-Match` está obsoleto o falta	Vuelva a leer y reenvíe con la nueva versión
`413`	Cuerpo o archivo demasiado grande	Envíe menos
`429` `RATE_LIMIT_EXCEEDED`, «Demasiadas solicitudes. Vuelva a intentarlo más tarde.»	El límite por dirección (120 por minuto)	Espere `Retry-After`
`429` «Se ha superado el límite de velocidad de la clave de API. Reduzca el ritmo.»	El límite por clave (1.000 por minuto por defecto)	Distribuya las llamadas
`429` «Se ha alcanzado el límite de velocidad de API de su plan…»	El límite del plan de la organización	Distribuya las llamadas o cambie el plan
`503` `TENANT_READ_ONLY`, «Este espacio de trabajo es de solo lectura mientras se traslada. Vuelva a intentarlo más tarde.»	La organización se está trasladando	Reintente tras `Retry-After` (300 s); las lecturas funcionan

Consulte Errores y límites de velocidad.

Inicios de sesión y mensajes de dispositivos

Código	Significado	Solución
CONNACK 1	Versión de MQTT no admitida	Use MQTT 3.1.1
CONNACK 2	ID de cliente rechazado	De 1 a 64 caracteres de `A–Z a–z 0–9 . _ : -`
CONNACK 3	Servidor no disponible, o la dirección bloqueada brevemente tras inicios de sesión fallidos	Espere con variación aleatoria; corrija el dispositivo con credenciales incorrectas
CONNACK 4	Usuario o contraseña incorrectos	Compruebe o rote la credencial
CONNACK 5	No autorizado; el motivo está en la pestaña Registro del dispositivo	Consulte Un dispositivo no se conecta
`unknown_reserved_topic`	Publicado en un tema desconocido bajo `v1/`	Use un tema documentado
`forbidden_topic`	Un tema de downlink, un tema de pasarela desde un no pasarela, o aprovisionamiento fuera de una sesión de aprovisionamiento	Use el tema correcto para el dispositivo
`tls_required` (HTTP `403`)	Una consulta de comandos por HTTP sin cifrar que el perfil no permite	Use HTTPS
`child_limit`, `device_limit`	Un dispositivo hijo de pasarela por encima del límite de hijos de la pasarela o del límite de dispositivos del plan	Aumente Máx. hijos de una pasarela en el perfil, o libere dispositivos
`child_rate_limited`	Un hijo de pasarela por encima de sus propios límites de velocidad	Reduzca la velocidad del hijo

Datos almacenados

Código	Significado
`key_invalid`, `key_too_long`, `key_reserved`	La clave incumple una regla: caracteres, 64 caracteres o un prefijo reservado (`_`, `fw_`, `current_fw_`, `cfg.`)
`string_too_long`, `value_too_large`	Texto de más de 1.024 caracteres; JSON de más de 4 KiB; un número que no es finito
`bad_form`	No es un formato que lea el almacén, o más de 1.000 puntos en un mensaje
`bad_ts`	Una marca de tiempo no expresada en milisegundos desde epoch, demasiado en el futuro (10 minutos por defecto) o más antigua de lo que permiten los ajustes
`too_old`	Más antiguo de lo que conserva su clase de retención para datos brutos
`no_values`	No se pudo almacenar nada del registro
`not_a_device`	Un Guardar telemetría en un flujo iniciado por una programación, un inject, un evento o un webhook, que no se refiere a un dispositivo
`range_too_large` (API de historial, `400`)	Más de 10.000 intervalos en la ventana

Consulte Los datos no llegan.

Comandos

Motivo	Significado
`bad_params`	Los parámetros no coinciden con el comando
`wait_too_long`	Una llamada síncrona espera como máximo 30 s; use `wait: false`
`confirm_required`, `confirm_text_mismatch`	Un comando de alto impacto necesita `confirm: true`, o el texto escrito es incorrecto
`method_refused`	Restablecimiento de fábrica, emparejamiento, olvidar Wi-Fi y olvidar la nube nunca se envían
`rpc_method_reserved`	El método pertenece a otro módulo
`rpc_not_supported_by_profile`	El perfil usa solo los temas Legacy
`device_not_active`	El dispositivo está deshabilitado o en cuarentena
`not_cancellable`	Solo se puede cancelar un comando en cola o enviado
`device_rate_limited`, «Demasiados comandos para este dispositivo; inténtelo de nuevo en un minuto.»	Más de 10 comandos por minuto a un dispositivo

Consulte Los comandos no llegan al dispositivo.

Flujos

Código o mensaje	Significado
`circuit_open`	Las llamadas salientes de un bloque fallaron repetidamente y están en pausa; se recupera solo
`ssrf_blocked`	La dirección es privada, no está en los hosts permitidos del endpoint o sale de la ruta base
`timeout`, `memory`, `blocked` (script)	El script usó más de su tiempo de CPU (50 ms por defecto) o 32 MiB; tras tres terminaciones seguidas se bloquea durante 60 segundos
`script_unavailable`, `host_busy`	El servicio de scripts no es accesible o está ocupado; reintente más tarde
`queue_full`	Un bloque retiene demasiados mensajes o claves
`flow_cycle`	Los flujos se disparan entre sí en un ciclo
«Estos bloques envían mensajes en un bucle que nunca espera»	Un ciclo sin un bloque de espera en un flujo
`no_recipients`, `too_many_recipients`, `members_unavailable`, `invalid_attachment`, `notify_failed`, `limit`	Errores de Notify: no hay nadie a quien avisar, más de 20 destinatarios después de resolver los roles, no se pudieron leer los miembros, un adjunto no válido, todas las entregas fallaron, o todos los canales sin cuota

Consulta Solución de problemas en flujos.

Alarmas y reglas

Mensaje	Solución
«Una clave nombra una clave de telemetría: sin espacios y no puede ser un número.»	Introduce el valor en Value, no en Key
«Otra regla de este perfil ya tiene este tipo.»	Usa un tipo único por perfil
«Entre 10 segundos y 7 días.»	El retardo de desconexión está fuera de rango
«Un silencio puede durar como máximo 90 días.»	Elige un final anterior
«El amanecer y el anochecer necesitan la ubicación del lugar: configúrala primero en el lugar.»	Define la latitud y la longitud en el activo
«Como máximo 20 acciones, incluidas las que están dentro de choices.»	Divide la regla de la tarjeta Rules
«Este tipo de dispositivo no tiene ese comando.»	Añade el comando al catálogo del perfil

Perfiles, activos y paneles

Mensaje	Solución
«Aún en uso por …: muévelos o elimínalos primero.»	Un perfil que aún usan dispositivos, reglas de alarma o comandos no se puede eliminar
«haz primero otro perfil el predeterminado»	El perfil predeterminado no se puede eliminar
«Un activo con activos hijos no se puede eliminar.»	Elimina o mueve primero los hijos
«Ese archivo no es un paquete de panel que esta versión entienda.»	Importa un archivo de panel exportado desde un panel de control
«Nada de este paquete se puede importar aquí.»	Instala primero los módulos o widgets que necesita el panel

Inicio de sesión

Mensaje	Solución
«Esta cuenta está bloqueada tras demasiados intentos fallidos de inicio de sesión. Vuelve a intentarlo más tarde o restablece tu contraseña.»	Espera o restablece la contraseña
«Demasiados códigos incorrectos. Espera unos minutos e inténtalo de nuevo.»	Espera
«Esta organización requiere verificación en dos pasos. Vuelve a iniciar sesión y complétala.»	Añade una passkey e inicia sesión con ella
«Esta cuenta está bloqueada por motivos de seguridad…»	Contacta con soporte

Consulta Problemas de inicio de sesión.

Cámaras y paneles de router

Mensaje o código	Solución
«Se ha pedido la imagen con demasiada frecuencia. Espera un momento e inténtalo de nuevo.»	Más de 24 solicitudes de enlace en directo por minuto para una cámara
«Hay demasiadas cámaras en uso en esta instalación en este momento. Inténtalo de nuevo en un momento.»	La capacidad de la instalación; reintenta
`ttl_idle`, `ttl_hard`, `lte_cap`, `no_dial` … (Ended because de la sesión del panel)	Consulta Límites y auditoría del acceso remoto