Como Validar CPF com API da Receita Federal

Introdução

A validação de CPF é uma etapa essencial em qualquer sistema que trabalhe com dados pessoais no Brasil. Neste guia completo, você aprenderá como implementar validação de CPF usando dados oficiais da Receita Federal através da API CPF Nacional.

Por que usar uma API oficial?

Ao contrário de validações apenas matemáticas, nossa API utiliza dados oficiais da Receita Federal, garantindo que o CPF esteja realmente ativo e válido no sistema governamental. Isso é crucial para:

• Prevenir fraudes em transações online
• Garantir conformidade com a LGPD
• Melhorar a experiência do usuário
• Reduzir custos operacionais

Exemplos de Integração

PHP

// Exemplo em PHP
$cpf = "12345678901";
$url = "https://api.cpf-brasil.org/api.php?cpf=" . $cpf;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: SUA_CHAVE_API"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

if ($data["success"]) {
    echo "CPF válido: " . $data["data"]["NOME"];
}

Python

# Exemplo em Python
import requests

cpf = "12345678901"
url = f"https://api.cpf-brasil.org/api.php?cpf={cpf}"

headers = {
    "X-API-Key": "SUA_CHAVE_API"
}

response = requests.get(url, headers=headers)
data = response.json()

if data["success"]:
    print(f"CPF válido: {data['data']['NOME']}")

Node.js

// Exemplo em Node.js
const axios = require("axios");

const cpf = "12345678901";
const url = `https://api.cpf-brasil.org/api.php?cpf=${cpf}`;

axios.get(url, {
    headers: {
        "X-API-Key": "SUA_CHAVE_API"
    }
})
.then(response => {
    if (response.data.success) {
        console.log(`CPF válido: ${response.data.data.NOME}`);
    }
});

JavaScript (Frontend)

// Exemplo em JavaScript
const cpf = "12345678901";
const url = `https://api.cpf-brasil.org/api.php?cpf=${cpf}`;

fetch(url, {
    headers: {
        "X-API-Key": "SUA_CHAVE_API"
    }
})
.then(response => response.json())
.then(data => {
    if (data.success) {
        console.log(`CPF válido: ${data.data.NOME}`);
    }
});

Tratamento de Erros

É importante tratar adequadamente os erros retornados pela API:

• CPF inválido: Retorna erro quando o CPF não existe ou está cancelado
• Rate limit: Limite de requisições excedido
• API Key inválida: Chave de API incorreta ou expirada

Conclusão

Com a API CPF Nacional, você tem acesso a dados oficiais da Receita Federal de forma rápida e confiável. Comece agora mesmo criando sua conta gratuita e tenha acesso a 10 consultas mensais sem custo!