Conceitos

Limites de uso

Limites por conta que protegem a plataforma e mantêm o app responsivo.

Requisições

Os limites valem por conta, somados entre todas as chaves, conexões OAuth e instâncias do servidor:

CategoriaLimite por minutoO que conta
Leituras240GET na API e cada chamada RPC ao MCP.
Alterações60POST, PUT e DELETE na API e ferramentas MCP de escrita.

Uma ferramenta MCP de escrita consome uma leitura (pela chamada RPC) e uma alteração. As janelas são de um minuto corrido no relógio do servidor.

Ao exceder o limite, a API responde 429 com Retry-After: 60. Dentro de uma ferramenta MCP, o resultado vem com isError: true e error.details.retryAfter = 60. Veja Limite de requisições.

Conteúdo

ItemLimite
Título1 a 160 caracteres
Texto do roteiro100 mil caracteres
Corpo da requisição1 MB
Página da bibliotecaaté 100 itens (limit)
Página do feedaté 200 itens (limit)

Credenciais

ItemLimite
Chaves ativas10 por conta
Validade de uma chave7, 30 ou 90 dias
Token OAuth de acesso5 minutos (renovável com offline_access)
Registro dinâmico (DCR)10 registros por minuto por IP

Webhooks

ItemLimite
Destinos5 por conta e ambiente
Cadastro, teste, rotação e reenvio5 por minuto, cada ação
Tentativas de entrega10 mil por dia por conta
Entregas pendentes2 mil por conta

Detalhes em Entregas e novas tentativas.