Créditos
Cada organização tem um plano que inclui um número mensal de créditos, e cada solicitação consome créditos conforme o que custa atendê-la:
As solicitações em lote consomem créditos por elemento: um
lote de 10 solicitações ao vivo consome 100. Os acertos de cache
(
X-Cache: HIT) consomem o mesmo que uma falha de cache. As solicitações que
falham não consomem nada, e consultar o estado de um job nunca consome
créditos.
Os créditos reiniciam na data mensal do plano e são administrados no
console. Os contratos têm seu
próprio número mensal.
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 a multiplica. Alguns endpoints têm um teto por hora adicional sobre a cota do plano, e a consulta de jobs usa uma cota própria:
Os tetos por hora são adicionais, não independentes: 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 seu limite.
Cota nos cabeçalhos de resposta
O estado do limite de taxa vem como cabeçalhos HTTP em cada resposta (não no corpo):Tentativas e idempotência
Toda operação do 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. Envie um cabeçalho opcionalIdempotency-Key (qualquer string de até 255 caracteres;
um UUID serve) e a API o devolve no cabeçalho de resposta Idempotency-Key,
para que você ligue uma nova tentativa à primeira nos seus logs. Cada tentativa
que chega à API conta contra a cota acima; um 429 pede para esperar
Retry-After segundos em vez de tentar de novo imediatamente.
| X-Request-Id | Id único da solicitação (req_…); inclua-o nos chamados de suporte. |
| X-Cache | HIT ou MISS em endpoints cacheáveis. Os acertos de cache também contam contra a sua cota. |
Quando os créditos se esgotam
Uma solicitação que os seus créditos restantes não cobrem retorna402 com um envelope
billing_error. Faça upgrade no console ou espere o reinício indicado em
X-RateLimit-Reset:
Quando você excede um teto por hora
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.