Códigos de error de API
Códigos de error de API
La API de Frame.io puede devolver los siguientes errores comunes:
Solución de errores comunes
Al usar un token de API válido para realizar tareas comunes, los errores más comunes son 403, 404 y 500. Un error 403 generalmente indicará uno de tres escenarios:
- El token que se ha usado en la solicitud, o el usuario al que pertenece el token, no tiene acceso suficiente al área de la cuenta de Frame.io donde se solicitó el recurso.
- El token no tiene suficientes Ámbitos para el recurso solicitado. Por ejemplo: llamar a
GET /comments/sin el ámbitocomments.read. - Un problema de tráfico de red impide que la API de Frame.io procese la solicitud. Si sospecha que un problema de tráfico de red está bloqueando sus solicitudes, póngase en contacto con el servicio de asistencia al cliente.
Un error 404 generalmente indicará que un recurso ya no existe, y que se ha movido o eliminado. Un error 500 generalmente indica una URL o cuerpo de la solicitud con formato incorrecto, pero también podría producirse cuando no hemos podido completar la solicitud dentro del periodo de tiempo disponible (30 s).
Limitación de frecuencia
La API de Frame.io aplica límites de frecuencia por token. El límite predeterminado para un token es de 50 llamadas por segundo. Algunos métodos tienen límites inferiores (por ejemplo, la solicitud POST /assets/:id/children tiene la frecuencia limitada a 5 activos por segundo).
Todos los límites están sujetos a cambios y, cuando se alcancen, devolverán un error HTTP 429. Le sugerimos que use un enfoque de retroceso exponencial para gestionar la limitación de frecuencia.
Consulte nuestra guía sobre límites de frecuencia para obtener más información.