Como usar consulta de CPF grátis para validar participantes de eventos

curl -X GET "https://api.cpfhub.io/cpf/12345678900" \
    -H "x-api-key: SUA_CHAVE_GRATUITA" \
    -H "Accept: application/json" \
    --connect-timeout 10 \
    --max-time 30

{
    "success": true,
    "data": {
    "cpf": "12345678900",
    "name": "Camila Ferreira Nunes",
    "nameUpper": "CAMILA FERREIRA NUNES",
    "gender": "F",
    "birthDate": "1992-01-15",
    "day": "15",
    "month": "01",
    "year": "1992"
    }
}

import requests
from typing import Dict, Optional

API_KEY = "SUA_CHAVE_GRATUITA"
TIMEOUT = 30

def validar_inscricao_evento(cpf: str, nome_informado: str) -> Dict:
    """
    Valida dados do participante durante a inscrição no evento.

    Returns:
    Resultado da validação com dados para o certificado
    """
    cpf_limpo = cpf.replace(".", "").replace("-", "").strip()

    if len(cpf_limpo) != 11 or not cpf_limpo.isdigit():
    return {
    "valido": False,
    "mensagem": "CPF com formato incorreto. Verifique e tente novamente.",
    "dados_certificado": None
    }

    try:
    response = requests.get(
    f"https://api.cpfhub.io/cpf/{cpf_limpo}",
    headers={
    "x-api-key": API_KEY,
    "Accept": "application/json"
    },
    timeout=TIMEOUT
    )
    response.raise_for_status()
    dados = response.json()

    if not dados.get("success"):
    return {
    "valido": False,
    "mensagem": "CPF nao localizado. Verifique o numero informado.",
    "dados_certificado": None
    }

    nome_api = dados["data"]["nameUpper"]
    nome_informado_upper = nome_informado.upper().strip()
    cpf_fmt = f"{cpf_limpo[:3]}.{cpf_limpo[3:6]}.{cpf_limpo[6:9]}-{cpf_limpo[9:]}"

    if nome_informado_upper == nome_api:
    return {
    "valido": True,
    "mensagem": "Dados confirmados com sucesso.",
    "dados_certificado": {
    "nome_completo": dados["data"]["name"],
    "cpf": cpf_fmt,
    "nascimento": dados["data"]["birthDate"]
    }
    }

    # Verificar nome parcial (abreviações comuns)
    palavras_api = nome_api.split()
    palavras_informadas = nome_informado_upper.split()

    if palavras_api[0] == palavras_informadas[0] and palavras_api[-1] == palavras_informadas[-1]:
    return {
    "valido": True,
    "mensagem": (
    f"Nome parcialmente compativel. "
    f"O certificado sera emitido como: {dados['data']['name']}"
    ),
    "dados_certificado": {
    "nome_completo": dados["data"]["name"],
    "cpf": cpf_fmt,
    "nascimento": dados["data"]["birthDate"]
    }
    }

    return {
    "valido": False,
    "mensagem": (
    f"O nome informado nao corresponde ao CPF. "
    f"Nome registrado: {dados['data']['name']}. "
    f"Corrija os dados e tente novamente."
    ),
    "dados_certificado": None
    }

    except requests.exceptions.Timeout:
    return {
    "valido": None,
    "mensagem": "Servico temporariamente indisponivel. Tente em alguns instantes.",
    "dados_certificado": None
    }
    except requests.exceptions.RequestException as e:
    return {
    "valido": None,
    "mensagem": "Erro na validacao. Tente novamente.",
    "dados_certificado": None
    }

# Exemplo
resultado = validar_inscricao_evento(
    cpf="123.456.789-00",
    nome_informado="Camila Ferreira Nunes"
)

if resultado["valido"]:
    print(f"Inscricao validada: {resultado['dados_certificado']['nome_completo']}")
else:
    print(f"Problema: {resultado['mensagem']}")

def credenciar_participante(cpf: str, lista_inscritos: dict) -> Dict:
    """
    Valida participante no credenciamento e confere com a lista de inscritos.

    Args:
    cpf: CPF do participante
    lista_inscritos: dicionário {cpf: dados_inscricao}
    """
    cpf_limpo = cpf.replace(".", "").replace("-", "").strip()

    # Verificar se está inscrito
    if cpf_limpo not in lista_inscritos:
    return {
    "credenciado": False,
    "mensagem": "Participante nao encontrado na lista de inscritos"
    }

    # Validar identidade via API
    try:
    response = requests.get(
    f"https://api.cpfhub.io/cpf/{cpf_limpo}",
    headers={
    "x-api-key": API_KEY,
    "Accept": "application/json"
    },
    timeout=TIMEOUT
    )
    response.raise_for_status()
    dados = response.json()

    if dados.get("success"):
    inscricao = lista_inscritos[cpf_limpo]
    return {
    "credenciado": True,
    "mensagem": f"Bem-vindo(a), {dados['data']['name']}!",
    "nome": dados["data"]["name"],
    "categoria": inscricao.get("categoria", "participante")
    }

    except (requests.exceptions.Timeout, requests.exceptions.RequestException):
    # Em caso de erro, confiar na lista de inscritos
    inscricao = lista_inscritos[cpf_limpo]
    return {
    "credenciado": True,
    "mensagem": f"Credenciado via lista (validacao API indisponivel)",
    "nome": inscricao["nome"],
    "categoria": inscricao.get("categoria", "participante")
    }

    return {"credenciado": False, "mensagem": "Erro na validacao"}

def gerar_certificado(dados_participante: Dict, evento: Dict) -> str:
    """Gera texto do certificado com dados validados."""
    certificado = f"""
    CERTIFICADO DE PARTICIPACAO

    Certificamos que {dados_participante['nome_completo']},
    inscrito(a) no CPF {dados_participante['cpf']},
    participou do evento "{evento['nome']}",
    realizado em {evento['data']} em {evento['local']},
    com carga horaria de {evento['carga_horaria']} horas.

    {evento['local']}, {evento['data_emissao']}
    """
    return certificado

# Uso
cert = gerar_certificado(
    dados_participante={
    "nome_completo": "Camila Ferreira Nunes",
    "cpf": "123.456.789-00"
    },
    evento={
    "nome": "Workshop de Integracao com APIs",
    "data": "15/09/2026",
    "local": "Sao Paulo - SP",
    "carga_horaria": "8",
    "data_emissao": "15/09/2026"
    }
)
print(cert)