> This page is for Plataforma, version Herdado.
> 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
> - Herdado: 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.

# Limites de taxa

# Visão geral

Seja um token distribuído por meio do Portal do desenvolvedor, concessão OAuth ou do back-end de contas que serve aos aplicativos do próprio Frame.io, **todas as chamadas de API ao Frame.io têm limites de taxa.**Os limites de taxa se aplicam a todas as solicitações de API de um usuário (independentemente de qual token ou método de autenticação é usado), são esgotados e reabastecidos progressivamente e são refletidos nos cabeçalhos de resposta de cada solicitação feita à API do Frame.io.Cada ponto de acesso é configurado com seus próprios limites, que variam de até `10` solicitações/minuto a até `100` solicitações/segundo.As solicitações que excederam o limite de taxa para um ponto de acesso específico recebem um erro HTTP `429` em resposta.

## Esgotamento e reabastecimento

A API do Frame.io usa uma estratégia de [leaky bucket](https://wikipedia.org/wiki/Leaky_bucket) de limitação de taxa progressiva, na qual os limites são atualizados gradualmente durante a janela de tempo definidaEm outras palavras, não há conceito de corte rígido após o qual os limites são atualizados para um recurso específico (ou seja, estratégias de aplicação de "janela fixa" e "janela deslizante").Em vez disso, os limites restantes são constantemente atualizados em um ritmo relativo ao limite e à janela de tempo de um recurso.

### Backoff exponencial




Nossa estratégia recomendada para gerenciar limites de taxa geralmente é chamada de "backoff exponencial".





Resumindo:




* Ao receber um erro `429`, pause por um período (normalmente um segundo)
* Se outro erro `429` for recebido, aumente exponencialmente o período de espera até que a função normal seja retomada




## Cabeçalhos




As respostas às solicitações de API sempre incluem os três cabeçalhos a seguir que devem ser utilizados para limitar suas solicitações de saída:




| Cabeçalho | Valor |
| ---------- | ---------- |
| `x-ratelimit-limit` | O limite de taxa para este caminho de recurso, medido em solicitações. |
| `x-ratelimit-remaining` | O número de solicitações restantes na janela de tempo atual. |
| `x-ratelimit-window` | A janela de tempo para os limites do caminho deste recurso, medida em milissegundos (ms). |




### Exemplo

O exemplo a seguir é da resposta para `GET v2/assets/:id/children`, para buscar os ativos filhos de uma raiz de projeto, pasta ou pilha de versões.O limite para esse caminho é de 40 solicitações por 60.000 ms (um minuto), e restam 39 solicitações após uma ter sido feita.

```
x-ratelimit-limit → 40
x-ratelimit-remaining → 39
x-ratelimit-window → 60000
```





## Detalhes

Os limites de taxa variam muito entre os caminhos de recursos na API do Frame.io.Abaixo estão alguns detalhes selecionados, expressos para facilitar a leitura como recurso e ação (por exemplo, "Ativos — Atualizar" em vez de `PUT /assets/:id`).

Como regra geral, os caminhos de recursos que criam novos dados são limitados a 100 chamadas por minuto ou menos, e os caminhos de recursos que buscam listas de ativos são limitados a 200 chamadas por minuto.




| Recurso | Ação | Limite (solicitações) | Janela de limite (ms) |
| ---------- | ---------- | ---------- | ---------- |
| **Ativos** | `create` | `5` | 1,000 |
| **Ativos** | `update` | `10` |
| **Ativos** | `read` | `5` | 1,000 |
| **Comentários<br />Apresentações<br />Projetos<br />Links de revisão<br />Equipes<br />Membros da equipe** | `create` | `100` | 60,000 |
| **Pesquisar** | `read` | `200` | 60,000 |