Documentação da Genesis API

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

Erros

Erros retornam o status HTTP correspondente com um corpo:

json
{
  "success": false,
  "error": {
    "code": "rate_limited",
    "message": "Requests per second limit exceeded."
  }
}
HTTPCódigoDescrição
400bad_requestParâmetros de requisição inválidos — detalhes em message
401invalid_keyChave ausente, inválida ou revogada, ou o plano da API expirou
403plan_restrictedO endpoint não faz parte do seu plano
404not_foundEndpoint ou recurso não encontrado
410goneO endpoint foi desativado — a substituição está em message
429rate_limitedLimite excedido — veja X-RateLimit e Retry-After
429download_limitedVolume de download excedido: 60 MB de dados comprimidos a cada 10 segundos por chave — veja Retry-After
500internal_errorErro interno, tente novamente mais tarde
503snapshot_not_readyOs dados estão sendo reconstruídos ou a fonte está reiniciando — tente novamente em alguns segundos, veja Retry-After

Cada resposta traz o cabeçalho X-Request-Id. Ao contactar o suporte, envie-o com a hora do pedido em UTC, o endpoint e o estado — nunca a sua chave.