Fallos habituales
Decide qué hacer a partir del estado HTTP y del code de la respuesta. No ramifiques tu lógica según el texto de message.
| Síntoma | Acción |
|---|---|
AUTH_INVALID | Revisa el clientId y el clientSecret |
APP_DISABLED | Confirma que el API Client y la aplicación están activos |
AUTH_SCOPE_DENIED | Añade el permiso que indica data.requiredScope y obtén un access token nuevo |
AUTH_EXPIRED | Obtén un access token nuevo y reintenta una vez la lectura fallida |
data.devices vacío | Confirma que el dispositivo pertenece a la cuenta y que el API Client puede acceder a él |
RATE_LIMITED | Espera lo que indique Retry-After; no reintentes de inmediato |
DEVICE_OFFLINE | Espera a que se reconecte, o usa el último estado sincronizado donde el endpoint lo ofrezca |
| Un comando no tiene resultado final | Consúltalo por su command ID; no repitas a ciegas una operación con efectos secundarios |
Anota el requestId cuando contactes con soporte.
Más ayuda
- Formato de respuesta (en inglés)
- Errores de autenticación y autorización (en inglés)
- Errores de recursos y comandos (en inglés)
- Preguntas frecuentes
- Contactar con soporte
