Regras de contabilização de consulta
Simples, previsível e totalmente transparente.
De forma geral, a Plataforma de Dados da BigDataCorp adota o princípio de 1 consulta = 1 cobrança. Sempre que uma requisição é processada com sucesso, a consulta é contabilizada independentemente da quantidade de dados retornados.
Em alguns cenários, a consulta pode ser contabilizada mesmo quando o retorno não contém as informações esperadas. Isso acontece porque, em determinados casos, a própria ausência de dados ou a validação realizada pela API já constitui uma resposta válida para a consulta efetuada.
A tabela abaixo resume os principais cenários em que uma consulta pode ou não ser contabilizada durante o processamento das requisições na Plataforma de Dados.
| Cenário | Cobrança | Observação |
|---|---|---|
| Documento inválido | Sim | A API retorna que o documento informado é inválido |
| Menor de idade | Sim | A consulta retorna que o documento pertence a um menor |
| Timeout inferior a 5 minutos | Sim | A consulta permanece em processamento pela plataforma |
| Timeout da fonte externa | Não | Retorna erro "DATASET IS TOO SLOW" |
| Consulta sem retorno de dados | Sim | A ausência de dados também constitui resposta válida, exceto em datasets de contato com documento válido |
| Erro 504 | Não | A requisição não chega a ser processada pela plataforma |
Status -130 - TOO MANY RESULTS | Não | Quando a chamada é realizada por chaves alternativas e o parâmetro Limit não foi definido. |
Detalhamento dos cenários:
A consulta é contabilizada quando a API identifica que o documento informado é inválido. Nesses casos, o retorno é acompanhado do código -114 — INVALID DOC PARAMETER, que representa uma resposta válida da plataforma.
Consultas relacionadas a menores de idade são contabilizadas, pois a identificação dessa condição faz parte do resultado da consulta. A cobrança segue regras específicas conforme a faixa etária e a data de nascimento informada. Saiba mais →
Quando uma consulta ultrapassa o tempo esperado de resposta, mas permanece em processamento pela plataforma por até cinco minutos, ela continua sendo considerada uma consulta válida e pode ser contabilizada normalmente.
O erro DATASET IS TOO SLOW indica lentidão ou indisponibilidade da fonte externa consultada. Como a resposta não pôde ser obtida junto à fonte, a consulta não é contabilizada.
A consulta é contabilizada mesmo quando não há dados disponíveis para retorno, pois a ausência de informação também constitui uma resposta válida da plataforma, com exceção nos datasets de contato (e-mail, telefone e endereço) quando o documento informado é válido.
O erro HTTP 504 normalmente está relacionado à infraestrutura de rede entre o sistema do cliente e a Plataforma de Dados. Como a requisição não chega a ser processada pela plataforma, a consulta não é contabilizada.
Quando a consulta é feita com uma chave fraca, como nome, e retorna o status -130 (TOO MANY RESULTS) por ausência de um Limit definido, a consulta não é contabilizada.
Updated 18 days ago