Códigos de error
Códigos de error
Referencia de los códigos de error devueltos por la API de GoVista.
Códigos de estado HTTP
| Código | Significado | Descripción | |--------|-------------|-------------| | 200 | OK | La petición ha tenido éxito | | 201 | Created | Recurso creado correctamente | | 204 | No Content | La petición ha tenido éxito, sin cuerpo en la respuesta | | 400 | Bad Request | Parámetros de petición inválidos | | 401 | Unauthorized | Clave API ausente o inválida | | 403 | Forbidden | Clave válida pero permisos insuficientes | | 404 | Not Found | El recurso no existe | | 409 | Conflict | El recurso ya existe o conflicto de estado | | 422 | Unprocessable | Petición válida pero con errores semánticos | | 429 | Too Many Requests | Límite de tasa superado | | 500 | Server Error | Error interno del servidor |
Códigos de error de la aplicación
Errores de autenticación:
AUTH_INVALID_KEY— La clave API es inválida o ha expiradoAUTH_INSUFFICIENT_SCOPE— La clave no tiene el scope requeridoAUTH_EXPIRED_SESSION— La sesión ha expirado, vuelve a autenticarte
Errores de dispositivo:
DEVICE_NOT_FOUND— El ID del dispositivo no existeDEVICE_OFFLINE— No se puede enviar comando a un dispositivo offlineDEVICE_ALREADY_PAIRED— El dispositivo ya está emparejado con una organizaciónPAIRING_CODE_EXPIRED— El código de emparejamiento de 6 caracteres ha expiradoPAIRING_CODE_INVALID— El código de emparejamiento es incorrecto
Errores de contenido:
CONTENT_NOT_FOUND— El asset de contenido no existeCONTENT_TOO_LARGE— El archivo supera el tamaño máximo de subidaCONTENT_INVALID_FORMAT— Formato de archivo no soportadoCONTENT_PROCESSING_FAILED— El servidor no pudo procesar el archivo subido
Errores de lista de reproducción:
PLAYLIST_NOT_FOUND— La lista de reproducción no existePLAYLIST_EMPTY— No se puede desplegar una lista vacíaPLAYLIST_ITEM_NOT_FOUND— El elemento de contenido en la lista fue eliminado
Comprueba siempre el campo error.code en las respuestas de error para gestionar los errores programáticamente. El campo error.message ofrece detalles legibles útiles para depuración.
Errores de programación:
SCHEDULE_NOT_FOUND— La programación no existeSCHEDULE_CONFLICT— La regla horaria entra en conflicto con reglas existentesSCHEDULE_INVALID_RULE— La configuración de la regla es inválida
Errores de límite de tasa:
RATE_LIMIT_EXCEEDED— Demasiadas peticiones, comprueba la cabecera Retry-After
Gestionar errores
Buenas prácticas:
1. Comprueba primero el código de estado HTTP 2. Parsea el código de error para una gestión programática 3. Registra la respuesta de error completa para depuración 4. Implementa exponential backoff para errores 429 5. Contacta con soporte si los errores 500 persisten
No reintentes errores 400, 401, 403 ni 404. Estos indican un problema con tu petición que hay que arreglar, no un problema temporal del servidor. Reintenta solo errores 429 y 500.