# 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.

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

- [Airtable Web API rate limits](https://airtable.com/developers/web/api/rate-limits): 5 requisições por segundo por base, 50 por token, espera de 30 segundos num 429. Verificado em 2026-11-05.
- [Airtable plans](https://support.airtable.com/articles/2277136852-airtable-plans-overview): chamadas de API por workspace por mês. Verificado em 2026-11-05.
- [List records](https://airtable.com/developers/web/api/list-records) e [Update multiple records](https://airtable.com/developers/web/api/update-multiple-records): página de 100; dez registros por requisição; upsert faz merge por um a três campos não calculados. Verificado em 2026-09-14.
- [Two-way syncing in Airtable](https://support.airtable.com/articles/8435404541-two-way-syncing-in-airtable): sem edição pela API num destino two-way. Verificado em 2026-09-14.