Documentação da Genesis API
Tudo para integrar: autenticação, limites, endpoints e esquemas de resposta.
DocumentaçãoErros
Erros
Erros retornam o status HTTP correspondente com um corpo:
json
{
"success": false,
"error": {
"code": "rate_limited",
"message": "Requests per second limit exceeded."
}
}| HTTP | Código | Descrição |
|---|---|---|
400 | bad_request | Parâmetros de requisição inválidos — detalhes em message |
401 | invalid_key | Chave ausente, inválida ou revogada, ou o plano da API expirou |
403 | plan_restricted | O endpoint não faz parte do seu plano |
404 | not_found | Endpoint ou recurso não encontrado |
410 | gone | O endpoint foi desativado — a substituição está em message |
429 | rate_limited | Limite excedido — veja X-RateLimit e Retry-After |
429 | download_limited | Volume de download excedido: 60 MB de dados comprimidos a cada 10 segundos por chave — veja Retry-After |
500 | internal_error | Erro interno, tente novamente mais tarde |
503 | snapshot_not_ready | Os 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.