> This page is for Plataforma, version Heredado.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 experimental: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - Heredado: https://next.developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# Códigos de error de API

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




| Código | Detalles | Motivos |
| ---------- | ---------- | ---------- |
| `401` | **Sin 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. |  |
| `402` | **Límite de uso superado**: Ha superado los límites de su plan de Frame.io. |  |
| `403` | **Prohibido**: No tiene acceso a ese recurso. Se devuelve tanto para el acceso del usuario como para el ámbito del token. |  |
| `404` | **No se ha encontrado**: El recurso no se ha encontrado. | El recurso se ha movido o eliminado. |
| `422` | **Argumentos no válidos**: Uno o más parámetros proporcionados no eran válidos. |  |
| `429` | **Frecuencia limitada**: Ha alcanzado el límite de frecuencia para la API. |  |
| `500` | **Error 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](./rate-limits) sobre límites de frecuencia para obtener más información.