Códigos de error de API

La API de Frame.io puede devolver los siguientes errores comunes:

CódigoDetallesMotivos
401Sin autorización: Token de API no válido. Asegúrese de que está utilizando la autenticación de token de portador y que está pasando su token a través del encabezado Authorization.
402Límite de uso superado: Ha superado los límites de su plan de Frame.io.
403Prohibido: No tiene acceso a ese recurso. Se devuelve tanto para el acceso del usuario como para el ámbito del token.
404No se ha encontrado: El recurso no se ha encontrado.El recurso se ha movido o eliminado.
422Argumentos no válidos: Uno o más parámetros proporcionados no eran válidos.
429Frecuencia limitada: Ha alcanzado el límite de frecuencia para la API.
500Error del Servidor: Nuestro servidor no sabe cómo interpretar su solicitud o no ha podido completar su solicitud dentro del periodo de tiempo disponible (30 segundos).URL o cuerpo de la solicitud con formato incorrecto, o no puede completar el proceso por algún otro motivo.

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:

  1. 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.
  2. El token no tiene suficientes Ámbitos para el recurso solicitado. Por ejemplo: llamar a GET /comments/ sin el ámbito comments.read.
  3. 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.