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:

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.
Il token non ha ambiti Scopes sufficienti per la risorsa richiesta. Ad esempio, se si chiama GET /comments/ senza l’ambito comments.read.
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 sui limiti di frequenza per saperne di più.