Uma cota por organização
Os limites 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 a multiplica.Tetos por hora
Alguns endpoints têm um teto por hora por cima do plano, e a consulta de jobs usa uma cota própria:
Os tetos são adicionais: uma chamada ao Research consome um dos seus 10
espaços por hora e 10 créditos do seu plano. A página de cada endpoint indica
o seu limite.
Cabeçalhos
O estado dos limites vem como cabeçalhos HTTP em cada resposta, não no corpo:Novas tentativas
Toda operação da Croma é uma consulta: repetir uma solicitação com o mesmo corpo devolve o mesmo resultado e nunca cria nem altera um registro, então tentar de novo após um timeout ou uma conexão perdida é sempre seguro. Um cabeçalho opcionalIdempotency-Key (qualquer string de até 255 caracteres;
um UUID serve) volta na resposta, para que você ligue uma nova tentativa à
primeira nos seus logs. Cada tentativa que chega à API conta; um 429 pede
para esperar Retry-After segundos em vez de tentar de novo imediatamente.
Quando você excede um teto
As solicitações que ultrapassam um teto por hora retornam429 com um
envelope rate_limit_error e um cabeçalho Retry-After (segundos):
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.