# Checklist: Tudo que Você Precisa Verificar Antes de Escolher uma API de CPF > Checklist completo com todos os critérios que você deve avaliar antes de escolher uma API de CPF. Técnicos, jurídicos, financeiros e operacionais. **Publicado:** 05/03/2024 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/checklist-escolher-api-cpf --- ## Introdução Escolher uma API de CPF parece simples à primeira vista, mas a decisão errada pode custar caro. Problemas de disponibilidade, falta de conformidade com a LGPD, documentação precária ou custos ocultos são apenas algumas das armadilhas. Este checklist reúne **todos os critérios** que você deve avaliar antes de assinar contrato com qualquer provedor. Use-o como referência para comparar opções e tomar uma decisão fundamentada. --- ## Critérios técnicos Os requisitos técnicos são a base da avaliação. Uma API pode ter o melhor preço do mercado, mas se não for confiável tecnicamente, o barato sai caro. | Critério | O que verificar | Sinal de alerta | |---------|----------------|----------------| | **Latência** | Tempo médio de resposta (p50, p95, p99) | p95 acima de 2 segundos | | **Disponibilidade** | SLA documentado e histórico de uptime | Sem SLA formal ou abaixo de 99% | | **Documentação** | Completude, exemplos, changelog | Docs desatualizados ou incompletos | | **Autenticação** | Método de autenticação utilizado | Sem suporte a API keys ou tokens | | **Rate limiting** | Limites claros e headers informativos | Limites não documentados | | **Versionamento** | Política de versionamento da API | Sem versionamento, breaking changes | - **Latência** -- solicite métricas reais de latência, não apenas promessas; teste você mesmo com chamadas de diferentes regiões - **Disponibilidade** -- peça o histórico de incidentes dos últimos 12 meses e verifique se existe uma status page pública - **Formato de resposta** -- verifique se a API retorna dados estruturados e consistentes em todos os cenários Teste rápido de latência com cURL: ```bash # Medir tempo de resposta da API curl -o /dev/null -s -w "\nDNS: %{time_namelookup}s\nConexão: %{time_connect}s\nTTFB: %{time_starttransfer}s\nTotal: %{time_total}s\n" \ -H "x-api-key: sua-chave-aqui" \ "https://api.cpfhub.io/cpf/12345678909" ``` --- ## Critérios de segurança e conformidade Com a LGPD em vigor, a conformidade não é opcional. Seu provedor de API de CPF manipula dados pessoais sensíveis e precisa tratá-los adequadamente. - **Criptografia em trânsito** -- verifique se a API usa TLS 1.2 ou superior em todas as comunicações - **Política de retenção** -- pergunte por quanto tempo os dados de consulta são armazenados nos logs do provedor - **Base legal LGPD** -- confirme qual base legal o provedor utiliza para o tratamento dos dados pessoais - **DPA (Data Processing Agreement)** -- exija um acordo de processamento de dados que defina responsabilidades - **Certificações** -- verifique se o provedor possui SOC 2, ISO 27001 ou certificações equivalentes - **Auditoria** -- pergunte se é possível auditar as práticas de segurança do provedor | Requisito LGPD | Obrigatório | Como verificar | |----------------|:-----------:|---------------| | Base legal para tratamento | Sim | Solicitar documentação formal | | Registro de operações | Sim | Verificar se provedor mantém logs | | DPA assinado | Sim | Exigir antes de contratar | | Notificação de incidentes | Sim | Cláusula contratual | | Criptografia TLS | Sim | Testar com `openssl s_client` | | Relatório de impacto (RIPD) | Recomendado | Solicitar cópia | --- ## Critérios financeiros O preço por consulta é apenas a ponta do iceberg. Avalie o custo total de propriedade (TCO) para evitar surpresas no orçamento. - **Modelo de precificação** -- entenda se é por consulta, por pacote, por assinatura mensal ou por volume escalonado - **Custos ocultos** -- verifique se existem cobranças por setup, suporte, ambiente de testes ou consultas que retornam erro - **Consultas sem resultado** -- pergunte se são cobradas consultas que não encontram dados para o CPF informado - **Compromisso mínimo** -- verifique se existe contrato mínimo, multa por cancelamento ou volume mínimo mensal - **Escalabilidade de preço** -- simule seu volume projetado para 6 e 12 meses e calcule os custos correspondentes ```python # Calculadora simples de custo mensal def calcular_custo_mensal(consultas_dia, preco_por_consulta, dias_uteis=22): consultas_mes = consultas_dia * dias_uteis custo_mensal = consultas_mes * preco_por_consulta custo_anual = custo_mensal * 12 return { "consultas_mes": consultas_mes, "custo_mensal": f"R$ {custo_mensal:,.2f}", "custo_anual": f"R$ {custo_anual:,.2f}", "custo_por_consulta": f"R$ {preco_por_consulta:.4f}", } # Exemplo: 500 consultas/dia a R$ 0,03 cada resultado = calcular_custo_mensal(500, 0.03) # {'consultas_mes': 11000, 'custo_mensal': 'R$ 330,00', ...} ``` --- ## Critérios operacionais e de suporte A qualidade do suporte técnico se revela nos momentos de crise. Avalie como o provedor lida com problemas antes de depender dele. | Critério | Ideal | Aceitável | Inaceitável | |---------|-------|-----------|-------------| | **Tempo de resposta do suporte** | < 1 hora | < 4 horas | > 24 horas | | **Canais de suporte** | Chat, email, telefone | Email, ticket | Apenas FAQ | | **Sandbox/ambiente de teste** | Gratuito e sempre disponível | Com limitações | Inexistente | | **SDKs oficiais** | Múltiplas linguagens | 1-2 linguagens | Nenhum | | **Status page** | Pública com histórico | Interna | Inexistente | | **Changelog** | Publicado com antecedência | Notificação por email | Sem aviso | - **Onboarding** -- avalie quanto tempo leva desde a criação da conta até a primeira consulta bem-sucedida - **Migração** -- pergunte se o provedor oferece suporte para migração de outro provedor - **Comunidade** -- verifique se existe fórum, Slack ou Discord para troca de experiências entre clientes - **Roadmap** -- pergunte sobre os planos de evolução da API e como as decisões de produto são comunicadas --- ## Perguntas frequentes ### O que é necessário para implementar validação de CPF neste contexto? A validação de CPF exige uma chamada à API com o número do documento e a chave de autenticação. A CPFHub.io retorna o status do CPF, nome do titular e data de nascimento em menos de 200ms, permitindo a verificação em tempo real durante o cadastro ou transação. ### A API CPFHub.io funciona para todos os volumes de consulta? Sim. O plano gratuito oferece 50 consultas por mês sem cartão de crédito — ideal para testes e projetos pequenos. Para volumes maiores, o plano Pro inclui 1.000 consultas mensais por R$149. Se o limite for ultrapassado, a API não bloqueia: cobra R$0,15 por consulta adicional. ### Como garantir conformidade com a LGPD ao usar uma API de CPF? Use o CPF apenas para a finalidade declarada ao titular, armazene apenas o necessário (não guarde o CPF cru se um token bastar), implemente controle de acesso aos logs de consulta e documente a base legal para o tratamento. A [ANPD](https://www.gov.br/anpd) orienta que dados de identificação devem ser tratados com o princípio da necessidade. ### Quanto tempo leva para integrar a API CPFHub.io? A integração básica leva menos de 30 minutos: crie uma conta em cpfhub.io, gere a API key no painel e faça uma chamada GET para `https://api.cpfhub.io/cpf/{CPF}` com o header `x-api-key`. A documentação inclui exemplos em Python, Node.js, PHP, Java e outras linguagens. ### Leia também - [SLA de API de CPF: níveis de disponibilidade e o que exigir do seu provedor](https://cpfhub.io/blog/sla-api-cpf-niveis-disponibilidade) - [API de consulta de CPF: diferenças entre planos gratuito, Pro e Corporate](https://cpfhub.io/blog/api-de-consulta-de-cpf-diferencas-entre-planos-gratuito-pro-e-corporate) - [APIs de CPF: como avaliar o custo-benefício antes de contratar?](https://cpfhub.io/blog/apis-de-cpf-como-avaliar-o-custo-beneficio-antes-de-contratar) - [Diferença entre validação de CPF e consulta de CPF: quando usar cada uma](https://cpfhub.io/blog/diferenca-entre-validacao-de-cpf-e-consulta-de-cpf-quando-usar-cada-uma) --- ## Conclusão Escolher uma API de CPF é uma decisão que impacta segurança, compliance, custos e experiência do usuário. Use este checklist como guia para avaliar provedores de forma estruturada, comparando não apenas preço, mas também critérios técnicos, de segurança, financeiros e operacionais. A [**CPFHub.io**](https://www.cpfhub.io/) atende a todos os critérios listados: SLA documentado, conformidade LGPD, plano gratuito para testes e suporte técnico via e-mail e WhatsApp. Acesse [cpfhub.io](https://www.cpfhub.io/) e faça sua primeira consulta em menos de 30 minutos.