Documentação da Genesis API

Tudo para integrar: autenticação, limites, endpoints e esquemas de resposta.

DocumentaçãoPlanos e limites

Planos e limites

Os limites são definidos pelo plano. O estado atual está sempre em /account/usage e nos cabeçalhos de cada resposta.

TrialStartProMax
Chamadas por mês500K2M5M10M
Requisições por segundo12515
Frescor dos dados60 s30 s10 s5 s

Endpoints fora do seu plano retornam 403 com o código plan_restricted. Requisições acima dos limites nunca são cobradas.

Apenas uma resposta 200 conta como chamada. Respostas 304 (não modificado) e erros 4xx/5xx não consomem a cota, mas contam para o limite de requisições por segundo.

O volume de download é limitado a 60 MB de dados comprimidos a cada 10 segundos por chave. Consultar todos os conjuntos de dados na frequência do seu plano cabe com folga; respostas abaixo de 64 KB não são contadas. Acima do limite — 429 download_limited até o fim da janela, sem cobrança. Economize tráfego com If-None-Match, filtros e o parâmetro coin.

Cabeçalhos de limites

CabeçalhoDescrição
X-RateLimit-LimitLimite de requisições por segundo do seu plano
X-RateLimit-RemainingRequisições restantes na janela atual
X-RateLimit-ResetTempo unix do reinício da janela
X-Quota-LimitCota de chamadas do período atual de 30 dias
X-Quota-RemainingChamadas restantes no período
X-Quota-ResetTempo unix do reinício da cota
Retry-AfterSegundos a esperar antes de repetir (com 429 e 503)