catbean.pages.dev

Como checar CPF com curl e API pública?

Verificar a validade de um CPF é uma tarefa comum em sistemas de cadastro e validação de dados. Utilizar uma API pública combinada com o comando curl é uma das formas mais rápidas e eficientes de automatizar esse processo diretamente da linha de comando, evitando a necessidade de desenvolver uma interface completa ou usar ferramentas pagas.

Pré-requisitos

Passo 1: Escolher uma API pública para validação de CPF

Existem várias APIs públicas disponíveis para validação de CPF. Uma das mais populares e gratuitas é a API da "ViaCEP" ou outras similares que oferecem endpoints para consulta de CPFs. Neste exemplo, usaremos uma API hipotética chamada "api-cpf-validacao.com".

API Endpoint: https://api-cpf-validacao.com/v1/validar/{CPF}

O comando curl permite enviar requisições HTTP diretamente do terminal. Para validar um CPF, você precisará substituir {CPF} pelo número do CPF desejado, sem pontos ou traços. A API geralmente retorna uma resposta em JSON indicando se o CPF é válido ou não.

curl -X GET "https://api-cpf-validacao.com/v1/validar/12345678901"

Passo 3: Processar a resposta da API

A resposta da API virá em formato JSON. Você pode usar ferramentas como jq (no Linux/macOS) para processar a saída e extrair apenas a informação relevante, como o status de validação.

curl -s "https://api-cpf-validacao.com/v1/validar/12345678901" | jq '.valido'

Exemplo Prático

Abaixo, uma tabela mostrando exemplos de CPFs e as respostas esperadas da API:

CPF de Entrada Comando curl Resposta JSON Esperada
12345678909 curl -s "https://api-cpf-validacao.com/v1/validar/12345678909" | jq '.' { "cpf": "12345678909", "valido": true, "mensagem": "CPF válido" }
11111111111 curl -s "https://api-cpf-validacao.com/v1/validar/11111111111" | jq '.' { "cpf": "11111111111", "valido": false, "mensagem": "CPF inválido" }
99999999999 curl -s "https://api-cpf-validacao.com/v1/validar/99999999999" | jq '.' { "cpf": "99999999999", "valido": false, "mensagem": "CPF inválido" }

Conclusão

Com este método, você automatiza a validação de CPFs em segundos, evitando erros manuais e integrando facilmente a rotinas de processamento de dados ou scripts de automação. A combinação de curl e APIs públicas oferece uma solução leve, rápida e eficaz para quem precisa validar CPFs em larga escala ou em sistemas simples.