Perguntas Frequentes

Como obtenho minha API Key?

Crie uma conta gratuita em app.cpfhub.io, acesse Configurações → API Keys e clique em Nova API Key. A chave é gerada na hora e não será exibida novamente. Guarde-a em um lugar seguro.

O plano gratuito tem limite de consultas?

Sim. O plano gratuito inclui 50 consultas por mês. Planos pagos oferecem volumes maiores e rate limits mais altos. Veja os planos disponíveis no painel.

Existe um ambiente sandbox para testes?

Não oferecemos um ambiente sandbox separado. Em vez disso, toda conta inclui 50 consultas gratuitas por mês: use-as para testar sua integração em produção sem custo. CPFs não encontrados (404) e CPFs inválidos (400/422) nunca consomem créditos, então você pode testar cenários de erro à vontade.

O que acontece quando o CPF não é encontrado?

A API retorna HTTP 404 com o código CPF_NOT_FOUND. Essa consulta não desconta créditos do seu plano: você só paga por consultas bem-sucedidas.

CPFs inválidos também consomem crédito?

Não. Consultas que retornam INVALID_CPF_FORMAT ou INVALID_CPF_DIGITS (dígitos verificadores errados) não consomem créditos. Apenas respostas 200 OK são cobradas.

A API armazena os CPFs consultados?

O CPFHub.io não armazena logs de consultas vinculados ao CPF pesquisado. Os dados retornados são provenientes de fontes públicas e são processados em memória. Consulte nossa política de compliance para detalhes completos.

A API é compatível com a LGPD?

Sim. A API consulta apenas dados de fontes públicas e não retorna informações sensíveis além do nome, gênero e data de nascimento. O uso é permitido para finalidades legítimas de verificação de identidade, KYC e prevenção de fraudes.

Qual é o tempo de resposta médio?

A API retorna respostas em ~150ms em média, com p99 abaixo de 500ms. O SLA de disponibilidade é de 99,9%.

Posso usar a API no frontend (browser)?

Tecnicamente sim, mas não é recomendado. Expor sua API Key no código client-side é um risco de segurança. Sempre faça as chamadas em um backend (servidor, serverless function, API Route no Next.js) e nunca inclua a chave em código público.

O rate limit é por segundo ou por minuto?

O Gratuito permite 1 requisição a cada 2 segundos. Os planos pagos (Starter, Pro e Business) permitem 1 requisição por segundo. Enterprise tem limite sob consulta. Ao exceder, a API retorna 429 com o header Retry-After indicando quantos segundos aguardar.

Existe SDK para minha linguagem?

Temos SDKs oficiais para 13 linguagens: Node.js, Python, Go, PHP, Java, Ruby, Rust, .NET/C#, Dart, Swift, Elixir, Lua e Nim. Todos com tipagem completa e exemplos prontos para produção.

Como cancelo minha assinatura?

Acesse o painel em app.cpfhub.io, vá em Configurações → Assinatura e clique em Cancelar plano. O cancelamento é imediato e você mantém o acesso até o fim do período pago.

O CPFHub.io tem suporte técnico?

Sim. Clientes com planos pagos têm acesso a suporte por email com SLA de resposta em até 24 horas úteis. Para dúvidas rápidas, a documentação e o playground cobrem a maioria dos casos.