Skip to main content

Cotas por organização

Os limites de taxa se aplicam por organização, não por chave. Cada chave emitida para a mesma organização compartilha uma mesma cota, então adicionar chaves não multiplica a sua cota. O limite padrão é de 100 solicitações por dia por organização. Alguns endpoints têm tetos mais estritos, cada um com sua própria cota: A página de cada endpoint indica seu limite. As solicitações em lote contam como uma solicitação por elemento: um lote de 10 elementos consome 10 da sua cota, igual a 10 chamadas individuais.

Cota nos cabeçalhos de resposta

O estado do limite de taxa vem como cabeçalhos HTTP em cada resposta (não no corpo):

Quando você excede o limite

As solicitações que ultrapassam a cota retornam 429 com um envelope rate_limit_error e um cabeçalho Retry-After (segundos):
Espere (faça back off) até Retry-After transcorrer (ou X-RateLimit-Reset), depois tente novamente.
O limitador falha aberto: se o backend de limite de taxa ficar indisponível por um momento, as solicitações passam e nenhum cabeçalho X-RateLimit-* é emitido. Não dependa de os cabeçalhos estarem sempre presentes.

A seguir: Erros

O envelope de erro e cada código de erro.