BDS0.1
ENPT

API

Com que velocidade e alcance uma integração lê e escreve: limites de taxa, página e lote, chaves de upsert e a API de metadados.

Revisado 2026-11-05Markdown

Uma integração lê e escreve registros pela API. Os limites abaixo valem por base, por token e por requisição.

Termos

Termo Significado
Token A credencial que uma integração envia em toda requisição. Um token pertence a um usuário ou conta de serviço.
429 A resposta que o Airtable devolve quando um cliente envia requisições demais.
Página Um bloco de registros numa leitura. Uma leitura de mais registros continua com um offset.
Upsert Uma escrita que atualiza o registro cujos campos de merge casam, e o cria quando nenhum casa.
API de metadados A parte da API que lê e muda o schema: tabelas, campos e views.

Limites

Limite Valor
Requisições por segundo por base 5
Requisições por segundo por token 50
Espera depois de um 429 30 segundos
Chamadas de API por workspace por mês ilimitadas no Business
Registros por página 100
Registros por requisição de escrita 10
Campos de merge do upsert 1 a 3
Edições pela API num destino two-way não permitidas

Limites de taxa

As 50 requisições por segundo por token cobrem todo o tráfego de uma conta. Isso vale para todas as bases.

O tráfego de sync não é documentado como parte do limite de API. Trate os dois como orçamentos separados.

Upsert

Os campos de merge de um upsert precisam ser campos gravados. Fórmula, lookup ou rollup não servem de chave de merge.

API de metadados

A API de metadados lê o schema. Ela cria tabelas e campos. Ela não apaga campos. Ela não cria views. Ela não lê as linhas de uma view.

Fontes