Skip to main content
As listas da API devolvem uma página por requisição. Cada workspace tem limites de leitura, e cada endereço IP tem um limite de requisições.

​
Paginação

Para ler uma lista inteira, comece com offset=0, some o limit ao offset a cada página e pare quando a resposta trouxer hasMore: false. Se a lista muda enquanto você a percorre, uma página pode repetir ou pular um item. Nas listas que começam pelos itens mais novos, como a de faturas, um item criado durante a leitura faz a página seguinte repetir o último item que você leu, e um item que sai da lista, como uma fatura que muda para um status fora do filtro, faz a página seguinte pular um item. Descarte os itens repetidos pelo id.

​
Limites de leitura por workspace

Cada workspace pode ter até 20 leituras em andamento ao mesmo tempo e fazer até 50 leituras por segundo, somando todas as suas chaves de API. Uma leitura é uma requisição GET ou HEAD, e fica em andamento desde que chega à Aira até a resposta terminar de ser enviada. Uma leitura acima de um desses limites recebe o status 429, com o header Retry-After e um code que nomeia o limite atingido, como descreve Respostas de erro. O limite de leituras em andamento só aceita uma nova leitura quando outra termina, então leia poucas páginas ao mesmo tempo.

​
Limite por endereço IP

Antes de chegar à API, cada requisição, de leitura ou de gravação, passa por um firewall que conta as requisições de cada endereço IP. Um endereço IP que faz mais de 5.000 requisições em 5 minutos recebe o status 429 em todas as requisições, até que a contagem dos últimos 5 minutos volte a ficar abaixo do limite. Um 429 sem um dos códigos dos limites de leitura vem desse limite: espere alguns minutos e reduza o ritmo das requisições.

​
Próximos passos