> This page is for Piattaforma, version Versione precedente.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 sperimentale: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - Versione precedente: 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.

# Codici di errore API

L'API Frame.io potrebbe restituire i seguenti errori comuni:




| Codice | Dettagli | Motivi |
| ---------- | ---------- | ---------- |
| `401` | **Unauthorized** -- Token API non valido. Verifica di utilizzare l'autenticazione con token bearer e di passare il token tramite l'intestazione Authorization. |  |
| `402` | **Usage exceeded** -- Hai superato i limiti del piano Frame.io. |  |
| `403` | **Forbidden** -- Non hai accesso a quella risorsa. Errore restituito sia per l'accesso utente che per l'ambito token. |  |
| `404` | **Not Found** -- Risorsa non trovata. | La risorsa è stata spostata o eliminata. |
| `422` | **Invalid arguments** -- Uno o più parametri forniti non erano validi. |  |
| `429` | **Rate Limited** -- Hai raggiunto il limite di frequenza per l'API. |  |
| `500` | **Server Error** -- Il nostro server non sa come interpretare la richiesta o non è riuscito a completarla nel tempo a disposizione (30 secondi). | Formato errato del corpo o dell'URL di richiesta oppure non è possibile completare l'operazione per qualche altro motivo. |




# Risoluzione dei problemi comuni

Quando utilizzi un token API valido per eseguire attività abituali, gli errori più comuni sono `403`, `404` e `500`. Un errore **403** di solito indica uno di tre scenari:
1. Il token utilizzato nella richiesta e/o l'utente a cui appartiene il token non ha accesso sufficiente all'area dell'account Frame.io dove è stata richiesta la risorsa.
2. Il token non ha ambiti [Scopes]() sufficienti per la risorsa richiesta. Ad esempio, se si chiama `GET /comments/` senza l'ambito `comments.read`.
3. Un problema di traffico di rete impedisce all'API Frame.io di elaborare la richiesta. *Se sospetti che le tue richieste vengano bloccate a causa di un problema di traffico di rete, contatta l'assistenza clienti.*

Un errore **404** di solito indica che una risorsa non esiste più, ovvero è stata spostata o eliminata. Un errore **500** di solito indica che il corpo o un URL di richiesta ha un formato errato, ma potrebbe anche verificarsi quando non riusciamo a completare la richiesta nel tempo a disposizione (30s).

# Limite di frequenza

L'API Frame.io applica limiti di frequenza per singolo token. Il limite predefinito per un token è di 50 chiamate al secondo. Alcuni metodi hanno limiti più bassi (ad esempio, POST `/assets/:id/children` ha un limite di 5 risorse al secondo).

Tutti i limiti sono soggetti a cambiamenti e, quando vengono raggiunti, restituiscono un errore HTTP 429. Suggeriamo di utilizzare un approccio di backoff esponenziale per gestire i limiti di frequenza.

Consulta [la nostra guida](./rate-limits) sui limiti di frequenza per saperne di più.